上九国威知识库 MCP

上九中国威士忌知识库 MCP · Shangjiu Chinese Whisky Knowledge Base MCP

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

国威品鉴 · 选酒导购 · 产区图谱 · 内容生成 ｜ 面向国产威士忌的 MCP 工具

🌏 在线体验

**** —— 一眼看懂「上九 · 国威知识库」是什么、能做什么，以及如何接入你的 AI 宿主。

⭐ GitHub · README · License · Fork · 🌏 在线落地页 · 🗺️ 产区图谱 · 📖 使用指南 · 🏆 贡献者榜

---

这是什么

「上九蒸馏所」做的一件小事：把中国威士忌讲清楚，并让 AI 能讲真话。

它是国威知识中枢对外的蒸馏出口 + 品鉴数据漏斗。国威缺的不是酒，是一套"人人能读、人人能引用、经得起核查"的讲法。所以我们做了一个——

• 薄插件：走标准 MCP 协议，接入任意 AI 宿主即用（Trae / Cursor / Claude Desktop…），不做独立 App。
• 诚实数据：每个字段带可信度标注（✅已核实 / 🟡待厂方确认 / ⬜待采集），不编造品鉴笔记与价格。
• 数据漏斗：submit_tasting_note 采集真人品鉴（AI 不判断），经复核后才可能进知识库——这是护城河的原材料。

一句话：这个工具的意义不是"更聪明的 AI"，而是让 AI 在讲中国威士忌时，说的都是真话。

---

功能亮点（五个标签）

---

快速开始

需要 Node ≥ 22（可原生剥离类型直接跑 .ts，无需构建）。

cd 上九国威知识库-mcp
npm install          # 或 pnpm install（本项目含 pnpm-lock.yaml）

npm start            # 启动 MCP 服务器（Node 原生直跑 src/index.ts）
npm run dev          # --watch 开发模式

# 免 npm 也能直接用（纯业务层，不依赖 MCP SDK）：
npm run demo         # 演示全部工具输出（含品鉴漏斗落盘）
npm run review       # 品鉴数据复核管线

服务器走 stdio，启动后无界面，等 MCP 宿主调用。日志输出到 stderr，不污染协议通道。

结构：src/data.ts（知识数据）与 src/tools.ts（业务逻辑）均为无依赖纯模块，可脱离 MCP 单独复用——即"知识资产独立于协议"。src/index.ts 只做 MCP 薄封装。

---

MCP 宿主配置

通用 stdio 配置（任何支持 MCP 的客户端）

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

若在某些宿主里"裸 node 找不到或路径出问题"，用项目自带的启动脚本：把 command 换成 /run-mcp.sh，args 留空。

Trae（推荐，国内可直接用）

Trae → 设置 → MCP → 添加，填：类型 stdio、命令 /run-mcp.sh（或 node + src/index.ts）、参数留空。Trae 的模型支持工具调用，能真正调用本插件。

Cursor

~/.cursor/mcp.json（或项目 .mcp.json）：

{
  "mcpServers": {
    "shangjiu-guowei": {
      "command": "/run-mcp.sh",
      "args": []
    }
  }
}

Claude Desktop（一键接入）

bash scripts/install-claude-config.sh

脚本会把 mcpServers.shangjiu-guowei 合并进 ~/Library/Application Support/Claude/claude_desktop_config.json 并填入项目绝对路径，之后完全退出并重启 Claude Desktop 即可调用。

---

对话示例

下面是无 GUI 的 stdio 管道验证命令（等价于宿主内部的调用序列）。

cat data/host-scenario.jsonl | node src/index.ts

真实宿主里的提问 → 工具调用效果：

已验证的返回效果（Trae 实测）：模型会先调用工具、返回知识库的真实数据，并诚实标注——

“数据来源：上九国威知识库 …价格带整体处于待采集状态，知识库目前的行业锚点是——崃州主力 100–400 元（口粮档）、叠川 888 元（高端锚点）。”

---

MCP 工具列表（9 个）

---

数据层（社区共建）

知识库的数据模型：产区(Region) → 酒厂(Distillery) → 产品(Product)，每个字段带 source（来源）与 confidence（可信度）。

可信度三档：✅ verified 已核实 / 🟡 pending 待厂方确认 / ⬜ unverified 待采集。

共建机制（真实数据 → 才进知识库）

真人品鉴 / 厂方一手信息
        │  submit_tasting_note（AI 只收集，不判断）
        ▼
   品鉴数据池  data/tasting-input.jsonl   （状态: pending_review）
        │  scripts/review.mjs：list / approve / reject / report
        ▼
   curated  data/tasting-approved.json    （真人复核通过）
        │  人工判断
        ▼
   进入知识库  src/data.ts                 （带 source + confidence）

社区怎样共建：

1. 提交品鉴：在宿主里调 submit_tasting_note，或直接用 node scripts/review.mjs 走复核。
2. 补充/更正数据：给 src/data.ts 提 PR —— 新增酒厂/产区/产品、补核实价格、更正错误。每条必须带来源，confidence 如实标注。
3. 厂方共建：面向新国威小厂——我们帮它们"把’你是谁’定义成标准 + 给声量"，换回它们的一手数据与内容授权（见策略定位）。

诚实守则（社区必须遵守）

• 不编造：品鉴笔记、价格、工艺细节，凡无一手来源一律留空标注。
• AI 只整理不判断：AI 做归并、可视化、追踪；不做主观品鉴结论。
• 出处可查：每个字段带 source 与 confidence。
• 待采即待采：标注 ⬜ 待采集 的，不等厂方确认不作结论。

---

贡献 (Contributing)

完整发布指南见 CONTRIBUTING.md（含改哪个文件、走哪条管线、具体命令与数据规范）。

欢迎一切形式的共建：

流程建议：Fork → 修改 → 提 PR；数据类 PR 请附来源链接，并如实标 confidence。我们会用 scripts/review.mjs 对品鉴数据做复核；tsc --noEmit 通过后方可合入。

🏆 贡献者奖励机制

我们为「被复核进库」的贡献者准备了明确的奖励——只奖励进库的贡献，不奖励提交动作，这是保护「诚实数据」的前提。

• CONTRIBUTORS.md —— 贡献者荣誉榜（谁、贡献了什么）
• docs/贡献者奖励规则.md —— 积分、等级徽章、四级奖励（可执行规则）
• docs/贡献者奖励机制方案.md —— 完整方案（背景、飞轮、路线图、风险）
• 在线榜单：contributors.html（自动统计更新）

---

项目结构

上九国威知识库-mcp/
├── package.json
├── tsconfig.json
├── .gitignore
├── LICENSE
├── README.md
├── CONTRIBUTING.md               # 贡献者发布指南（具体路径/命令/规范）
├── run-mcp.sh                      # 一键启动脚本（规避命令路径问题）
├── claude_desktop_config.example.json
├── src/
│   ├── data.ts        # 国威知识库（纯数据 + 类型，无外部依赖）
│   ├── tools.ts       # 业务逻辑层（纯函数，无 MCP SDK）
│   └── index.ts       # MCP 服务器（薄封装，stdio）
├── scripts/
│   ├── demo.mjs        # 免 npm 演示所有工具
│   ├── review.mjs      # 品鉴数据复核管线
│   ├── host-demo.mjs   # 真实宿主演示（官方 SDK Client）
│   ├── install-claude-config.sh  # 一键接入 Claude Desktop
│   └── mcp-probe.mjs   # 端到端协议探针（标准机器）
└── data/
    ├── host-scenario.jsonl   # 管道演示会话
    └── probe-requests.jsonl  # 探针会话

---

路线图

• v0.1：骨架 + 可信度标注；品鉴漏斗本地落盘。
• v0.2：品鉴数据复核管线（真人复核→才进知识库）；业务层抽成 tools.ts；免 npm 演示。
• v0.3：真实接入 —— Claude Desktop 一键配置、SDK 宿主演示、管道演示。
• v0.4（当前）：选酒导购 recommend_whisky；内容生成 generate_content；扩充产区/酒厂档案（滇西茶威、胶东、亳州草本、西藏青稞等）。
• 🏷 2026-10-02 情报批次：酒厂 19 → 23 家（新增隐象、万季、久溪、青岛牌）；补录 觀橡 WWA 2026「世界最佳调和麦芽」、崃州 WWA 2026「中国最佳单一麦芽」、叠川 2024 ISC 金奖、古奇蒙古栎桶 80 万元拍卖；3 项标准补齐官方编号（T/CNLIC 0246-2026、T/HZAS 118—2026、税委会公告 2026 年第 1 号）；修正「64 家」与进口份额口径、崃州泥煤波本规格。评估报告与取证档案见 docs/最新国产威士忌收录评估-2026-10-02.md。
• 🏷 2026-10-07 情报批次：产区 11 → 16 带（新增 什邡（四川）、内蒙古（库伦/太仆寺旗）、恩施（湖北）、永泰（福州）、普洱（滇南）），酒厂 23 → 30 家（新增熊猫精酿·什邡、农湾双龙谷·库伦旗、农湾双龙谷·恩施、西鸽永泰酒庄、山河馏心·普洱、内蒙古克劳德、云凰）；赛事奖项线升级为官方数据源（WWA 2026 官网 ID 区间枚举得 39 条中国区记录：吉斯波尔「Symbol」单一麦芽·12 年及以下子类别冠军、太瓏釀「Best Chinese Grain」、青岛牌 Gold；ISC 2026 官方 JSON：崃州 1 金 7 银等）；新增 T/TMAC 455-2026《威士忌 固态发酵法》 标准对象、WHISKY_STANDARD 补 6 项硬指标（木桶≤700L、高级醇≤6.0 g/L、总醛≤0.5 g/L 等，来源为中酒协官方解读）；纠正 3 处库内事实（高桥「2026-05 试生产」→ 截至 2026-10-05 尚未出酒；叠川 ISC 年份写实 2024；千岛湖「已集聚 6 家」≠ 全部投产，并更正上轮归因）；崃州泥煤波本维持 46/50 双记、新增「雪莉醇境」。评估报告与取证档案见 docs/最新国产威士忌收录评估-2026-10-07.md。
• v0.5：盲品会数据接入；面向小厂的"品牌定制风味库"接口；内容生成流程产品化。
• v0.6：社区共建引擎（贡献者激励 / 数据审核面板）；跨语言 SDK。

---

License

MIT —— 见 LICENSE。欢迎自由使用、修改、再分发；引用数据时请保持出处标注。