面向国产威士忌的 MCP 工具

让世界喝懂中国威士忌
的开源 AI 插件

不是"更聪明的 AI",而是让 AI 讲中国威士忌时说的都是真话。标准 MCP 协议,接入任意 AI 宿主即用;每个字段带可信度标注,绝不编造品鉴与价格。

国威品鉴 选酒导购 产区图谱 内容生成 MCP · 开源 · 社区共建
01

四个方向,一个知识中枢

品鉴

国威品鉴

查酒厂档案、风味图谱,每个判断都带出处与可信度。

get_distilleryget_flavor_profile
导购

选酒导购

预算+口味+场景,帮你挑一支真正适合的国产威士忌。

recommend_whiskylist_products
图谱

产区图谱

邛崃、峨眉山、千岛湖、大理、滇西、胶东、亳州、青藏、大湾区。

list_regionssearch_whisky
生成

内容生成

选题 / 长文 / 小红书 / 短视频骨架,基于真实知识,不胡说。

generate_contentsubmit_tasting_note
02

MCP 工具 · 9 个

走标准协议,任意宿主可调
list_regions
产区萌芽体系邛崃/峨眉山/千岛湖/大理/滇西/胶东/亳州/青藏/大湾区
list_distilleries
酒厂列表按产区过滤
get_distillery
酒厂档案产区/工艺/风土/产品/可信度
get_flavor_profile
风味图谱主导词 + 官方/社区来源
list_products
产品线与价格带含行业价格锚点
search_whisky
全库检索酒厂名/产区/风格/风味词/故事
recommend_whisky
选酒导购预算+口味+场景 → 打分推荐
generate_content
内容生成选题/长文/小红书/短视频骨架
submit_tasting_note
品鉴漏斗采集真人品鉴,经复核才进知识库
03

快速开始

Node ≥ 22,免构建,原生跑 .ts
# 拉取 & 安装
git clone https://github.com/1281227309-art/shangjiu
cd shangjiu
npm install          # 或 pnpm install

# 启动 MCP 服务器(stdio,等宿主调用)
npm start

# 免 npm 快速验证工具层
node scripts/demo.mjs
  • 薄插件:标准 MCP 协议,不做独立 App
  • 知识独立于协议:数据/业务层为纯模块,可脱离 MCP 复用
  • 无依赖演示:demo / review 脚本免 SDK 直接跑
  • 诚实数据:✅已核实 / 🟡待厂方确认 / ⬜待采集
04

接入你的 AI 宿主

Trae(推荐 · 国内可用)

Trae → 设置 → MCP → 添加,类型 stdio,命令填项目绝对路径。

// 命令
node /path/to/shangjiu/src/index.ts

Claude Desktop(一键)

运行脚本即合并进 Claude 配置,完全退出重启即可。

bash scripts/install-claude-config.sh

通用 stdio 配置

{ "mcpServers": {
    "shangjiu-guowei": {
      "command": "node",
      "args": ["/path/to/shangjiu/src/index.ts"]
    } } }

Cursor

// ~/.cursor/mcp.json
{ "mcpServers": { "shangjiu-guowei":
  { "command": "node",
    "args": ["/path/to/shangjiu/src/index.ts"] } } }
05

数据层 · 社区共建

真实数据,才进知识库
  • 来源可查:每字段带 source 与 confidence
  • 可信度三档:✅ 已核实 / 🟡 待厂方确认 / ⬜ 待采集
  • 品鉴只收真人:submit_tasting_note → 复核 → curated → 进库
  • 小厂共建:帮它们"定义你是谁 + 给声量",换一手数据与授权
真人品鉴 / 厂方一手信息
     │  submit_tasting_note(只收集,不判断)
     ▼
  品鉴数据池 (pending_review)
     │  scripts/review.mjs  复核
     ▼
  curated (approved) → 人工判断 → src/data.ts
06

诚实,是这套东西的资产

01
不编造品鉴笔记、价格、工艺,凡无一手来源一律留空标注。
02
AI 只整理,不判断AI 做归并、可视化、追踪;不做主观品鉴结论。
03
出处可查每个字段带 source,任何引用都经得起核查。
04
待采即待采标 ⬜ 的不作结论,不等厂方确认不硬讲。

想一起把中国威士忌讲清楚?

提交你的真实品鉴,或加入共建。让 AI 讲国威时,说的都是真话。

Star / Fork 本项目