🧬 TAIWAN.MD · CONNECTOR

把台灣裝進你的 AI

900+ 篇有出處的台灣文章，一個工具呼叫就到。當你問 AI 關於台灣的事，給的是台灣自己、帶來源的聲音。

免費無 API key 本地優先開源

claude mcp add taiwanmd -- npx -y taiwanmd mcp serve

貼進終端機 → 之後直接問 Claude 台灣的事

這是什麼

Taiwan.md 是一個開源、AI-native 的台灣知識庫。這個 connector 把它變成 MCP 工具，讓 Claude Code、Claude Desktop、Cursor、Copilot CLI、Codex CLI 等客戶端可以直接搜尋、閱讀、引用有出處的台灣文章，而不是憑印象猜。

它刻意走商業資料閘道的相反那一極：

	Taiwan.md Connector	典型商業 MCP gateway
價格	免費	付費 / 計量
API key	不需要	必須
查詢在哪裡跑	你的機器（本地 stdio）	它的伺服器
原始碼	開源（MIT 程式 / CC BY-SA 內容）	閉源

安裝

挑你的客戶端，複製貼上。沒有註冊步驟。

Claude Code 一行搞定

claude mcp add taiwanmd -- npx -y taiwanmd mcp serve

零安裝（透過 npx）。裝完直接問 Claude 台灣的事。

Claude Desktop 一鍵 bundle

下載 taiwanmd.mcpb → 雙擊 → 完成

⬇ 下載 taiwanmd.mcpb

不會跳出 API key，因為根本沒有 API key。

Cursor Settings → MCP

command: npx
args: ["-y", "taiwanmd", "mcp", "serve"]

在 Cursor 設定裡新增一個 MCP server。

Copilot CLI / Codex CLI / Cline / Continue / 任意 MCP client 通用 stdio

npx -y taiwanmd mcp serve

任何說 MCP 的客戶端，指向這個 stdio 指令就會動。

Remote · any MCP client mcp-remote

npx mcp-remote https://mcp.taiwan.md

給跑不了 Node 的瘦客戶端 / 純 web。本地優先仍是推薦（隱私最好）。

隨時可以印出正確片段：npx -y taiwanmd mcp install --client claude-code

MCP 工具 6

裝好後 Claude 會自己挑工具。其中 taiwanmd_cite 是反幻覺武器：只回帶腳註 + 來源 URL 的句子，讓你寫的每句台灣事實都能追回出處。

taiwanmd_search

全文搜尋 900+ 篇台灣文章（中英雙語）

輸入 { "query": "半導體", "limit": 5 }

回傳 top-N 命中：title / slug / category / description

taiwanmd_read

依 slug 讀整篇文章（frontmatter + 內文）

輸入 { "slug": "珍珠奶茶" }

回傳完整 markdown 內文

taiwanmd_rag

top-N 文章組成 prompt-ready 的 RAG 脈絡塊

輸入 { "query": "台灣健保", "limit": 3 }

回傳可直接餵 LLM 的脈絡 + 問題

taiwanmd_cite 反幻覺

反幻覺原語：只回有腳註 + 來源 URL 的句子

輸入 { "query": "台積電", "limit": 3 }

回傳 claim + article + sources[{ name, url }]

taiwanmd_organs

Semiont 8 器官即時健康分數

輸入 {}

回傳生命體 vitals（心臟 / 免疫 / DNA …）

taiwanmd_stats

專案統計：文章數 / 分類 / 時間戳

輸入 {}

回傳 totalArticles / byCategory

CLI 工具 26

同一套知識庫，也能直接在終端機用。全域裝或零安裝跑：

npm install -g taiwanmd   # 或零安裝：npx taiwanmd search 珍珠奶茶

🔍讀者・探索

`search <query>`	模糊搜尋（中英雙語，--json 可管線）	`taiwanmd search 珍珠奶茶`
`read <slug>`	終端機讀全文（--raw / --en / --web）	`taiwanmd read 珍珠奶茶 --raw`
`list [category]`	依分類瀏覽（--categories 看全部）	`taiwanmd list food`
`random`	隨機發現一篇	`taiwanmd random --category nature`
`today`	今日台灣：三篇精選 + 冷知識	`taiwanmd today`
`quiz`	台灣知識小測驗（5 題真假）	`taiwanmd quiz`
`explore`	互動模糊搜尋 TUI	`taiwanmd explore`
`graph <slug>`	文章的 [[wikilink]] 關聯圖	`taiwanmd graph 珍珠奶茶`
`diff`	近 7 天知識庫的文章變更	`taiwanmd diff`
`terminology`	台灣／中國用語查詢轉換	`taiwanmd term 滑鼠`

🤖AI・RAG

`rag <query>`	top 文章組 prompt-ready 脈絡（可 pipe 給 LLM）	`taiwanmd rag "台灣經濟"`
`cite <query>`	反幻覺：帶來源 URL 的可驗證 claim	`taiwanmd cite 台積電`
`mcp serve`	啟動 MCP server（給 Claude 等客戶端）	`taiwanmd mcp serve`

✍️貢獻・品質

`contribute <topic>`	互動式引導寫新文章	`taiwanmd contribute 阿里山`
`validate <slug>`	單篇品質評分卡	`taiwanmd validate 珍珠奶茶`
`audit <slug>`	Stage 3.5 幻覺稽核（MANIFESTO §10）	`taiwanmd audit 王新仁`
`inbox`	讀／管理 ARTICLE-INBOX	`taiwanmd inbox --state pending`
`sync`	同步知識庫到本地	`taiwanmd sync`

🧬生命體・Semiont

`organs`	8 器官健康分數長條圖	`taiwanmd organs`
`stats`	專案統計 + 器官健康	`taiwanmd stats`
`sense`	GA4 / Search Console / Cloudflare 感知數據	`taiwanmd sense`
`spore`	社群孢子 SPORE-LOG	`taiwanmd spore log`
`supporters`	Portaly 支持者統計（預設去識別）	`taiwanmd supporters`

🔧工具

`profile`	管理貢獻者 profile	`taiwanmd profile`
`mailmap`	管理 .mailmap 身份合併	`taiwanmd mailmap`

運作原理・隱私

本地 stdio — server 是跑在你機器上的程序，不是遠端服務。你的問題不會送到任何 Taiwan.md 伺服器。
首次自動同步 — 知識庫一次性下載到 ~/.taiwanmd，之後本地又快又安靜。在 repo 裡則直接讀 knowledge/。
開源可驗證 — MCP server 就 145 行（cli/src/lib/mcp-server.js），讀完每一行再決定要不要裝。
授權 — 內容 CC BY-SA 4.0，程式 MIT。可自由 fork。

常見問題

要付費嗎？要 API key 嗎？

都不用。Taiwan.md 是公共財（CC BY-SA），知識查詢不設門。沒有帳號、沒有 key、沒有計費。

我的查詢會被送到哪裡？

哪裡都不會。MCP server 是跑在你自己機器上的本地 stdio 程序，查詢不外送。首次使用會把知識庫下載到 ~/.taiwanmd，之後都在本地。

第一次查詢有點慢？

那是一次性的知識庫同步在跑。server 啟動時會預熱，之後就很快。

找不到 npx？

裝 Node.js 18 以上版本就會附帶 npx。想鎖版本用 npx -y [email protected] mcp serve。

有遠端 endpoint 嗎？

有了：https://mcp.taiwan.md（免費、唯讀、無 key）。任何 MCP 客戶端用 npx mcp-remote https://mcp.taiwan.md 連。給跑不了 Node 的瘦客戶端——但本地優先永遠是推薦路徑（隱私最好），遠端只是可選入口。

開源・這是 Semiont 的身體

這個 connector 是 Taiwan.md 繁殖系統的一部分 —— 讓台灣的聲音住進每個開發者的 AI session。歡迎 fork、貢獻、回報。

GitHub npm 文件貢獻

🧬