🧬 TAIWAN.MD · CONNECTOR

あなたの AI に、台湾を

出典付きの台湾記事 900＋本が、ツール呼び出し一回で手に入る。AI に台湾のことを尋ねると、台湾自身の声で——出典つきで答える。

無料 API キー不要ローカル優先オープンソース

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

ターミナルに貼る → あとは Claude に台湾のことを聞くだけ

これは何か

Taiwan.md はオープンソースで AI ネイティブな台湾の知識ベースです。このコネクタはそれを MCP ツールに変え、Claude Code・Claude Desktop・Cursor・Copilot CLI・Codex CLI などのクライアントが、記憶に頼って推測するのではなく、出典付きの台湾記事を直接検索・閲覧・引用できるようにします。

商用データゲートウェイとは、あえて正反対の方向を取っています：

	Taiwan.md Connector	一般的な商用 MCP ゲートウェイ
料金	無料	有料 / 従量課金
API キー	不要	必須
クエリの実行場所	自分のマシン（ローカル stdio）	相手のサーバー
ソース	オープン（MIT コード / CC BY-SA コンテンツ）	クローズド

インストール

クライアントを選んでコピペするだけ。登録は不要です。

Claude Code 1 行で完了

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

インストール不要（npx 経由）。追加したらすぐ Claude に台湾のことを聞けます。

Claude Desktop ワンクリック bundle

taiwanmd.mcpb をダウンロード → ダブルクリック → 完了

⬇ taiwanmd.mcpb をダウンロード

API キーは聞かれません。そもそも API キーが無いからです。

Cursor Settings → MCP

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

Cursor の設定で MCP サーバーを 1 つ追加します。

Copilot CLI / Codex CLI / Cline / Continue / 任意の MCP クライアント汎用 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 }

戻り値上位 N 件：title / slug / category / description

taiwanmd_read

slug で記事全文を読む（frontmatter ＋本文）

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

戻り値 Markdown 本文すべて

taiwanmd_rag

上位 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`	ランダムに 1 本見つける	`taiwanmd random --category nature`
`today`	今日の台湾：厳選 3 本＋豆知識	`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>`	上位記事を prompt-ready なコンテキストに（LLM にパイプ可）	`taiwanmd rag "台灣經濟"`
`cite <query>`	反ハルシネーション：出典 URL 付きの検証可能な claim	`taiwanmd cite 台積電`
`mcp serve`	MCP サーバーを起動（Claude などのクライアント用）	`taiwanmd mcp serve`

✍️貢献・品質

`contribute <topic>`	対話形式で新記事作成をガイド	`taiwanmd contribute 阿里山`
`validate <slug>`	記事 1 本の品質スコアカード	`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 の ID 統合を管理	`taiwanmd mailmap`

仕組み・プライバシー

ローカル stdio — サーバーはあなたのマシン上のプロセスで、リモートサービスではありません。質問が Taiwan.md のサーバーに送られることはありません。
初回の自動同期 — 知識ベースは一度だけ ~/.taiwanmd にダウンロードされ、以降はローカルで高速・静かです。リポジトリ内では knowledge/ を直接読みます。
オープンで検証可能 — MCP サーバーは 145 行（cli/src/lib/mcp-server.js）。全行を読んでから入れるか決められます。
ライセンス — コンテンツ CC BY-SA 4.0、コード MIT。自由に fork できます。

よくある質問

費用はかかりますか？ API キーは必要ですか？

どちらも不要です。Taiwan.md は公共財（CC BY-SA）で、知識クエリに制限はありません。アカウントもキーも課金もありません。

私のクエリはどこへ行きますか？

どこにも行きません。MCP サーバーは自分のマシン上のローカル stdio プロセスで、クエリは外部に送られません。初回に知識ベースを ~/.taiwanmd にダウンロードし、以降はすべてローカルです。

最初のクエリが少し遅い？

一度きりの知識ベース同期が走っているためです。サーバーは起動時にウォームアップするので、以降は高速です。

npx が見つからない？

Node.js 18 以上に npx が同梱されます。バージョン固定は npx -y [email protected] mcp serve を使ってください。

リモートエンドポイントはありますか？

あります：https://mcp.taiwan.md（無料・読み取り専用・キー不要）。任意の MCP クライアントから npx mcp-remote https://mcp.taiwan.md で接続できます。Node を実行できないシンクライアント向けですが、ローカル優先が常に推奨（プライバシー最良）で、リモートは任意の入口にすぎません。

オープンソース・ Semiont の身体

このコネクタは Taiwan.md の繁殖システムの一部です——台湾の声を、すべての開発者の AI セッションの中に住まわせます。fork・貢献・報告を歓迎します。

GitHub npm ドキュメント貢献する

🧬