OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown)

opencidian-mcp

Perxel によるオープンな中国語・ベトナム語辞書、OpenCidian のリモート MCP サーバーです。システムが利用できる唯一の公開アクセス手段です。公開 API はありません。suggest_correction を除き、読み取り専用です。suggest_correction はメンテナー向けの公開 GitHub issue を作成します（データは変更しません）。サインインは不要です。opencidian-api の上に、Perxel MCP Kit（kit/、STANDARD.md を参照）を使って構築された Cloudflare Worker です。opencidian-api は内部向けであり、この Worker がサービスバインディング経由で送信する X-MCP-Secret がない場合、すべての読み取りリクエストに 404 を返します。

opencidian-mcp (this repo) ──service binding──▶ opencidian-api ──▶ D1
  POST /mcp (Streamable HTTP, stateless)           loaded from opencidian-data's releases

GET / では接続手順とすべてのツールを確認できます。GET /llms.txt には、OpenCidian の概要、接続方法、質問例、ライセンス、帰属表示が記載されています（src/lib/llms.ts）。/dash は公開利用状況ダッシュボードです。ホスト：opencidian-mcp.perxel.com。

ツール

ツール	呼び出し先	備考
lookup	GET /v1/lookup	漢字、ピンイン（声調あり・なし）、またはベトナム語で検索できます。by で読みを指定でき、limit は 1～50 です。
get_character	GET /v1/chars/{char}	Hán Việt、ピンイン、部首、構成要素、語源、画数、繁体字の形を取得します。
words_with	GET /v1/words-with/{char}	指定した文字を含む 2 文字以上の単語を取得します。HSK の単語が先に表示されます。
search_meaning	GET /v1/search	ベトナム語（デフォルト）または英語の意味から、中国語の候補語を検索します。
annotate_text	POST /v1/annotate	テキスト（最大 2,000 文字）を、ピンイン、Hán Việt、意味付きの単語に変換します。
suggest_correction	POST /v1/corrections	opencidian-data に公開 issue を作成します（ラベルは correction、from-ai）。メンテナーが修正ファイルに反映します。データは変更しません。すべての MCP 呼び出し元を合わせて、1 分あたり 5 件までです。
about	GET /v1/meta	バージョン、ライセンス、完全な帰属表示、固定されたバージョン付きの各ソースを取得します。

すべての応答には、フィールドごとの src、データセットのバージョン、簡潔なクレジットが含まれます。応答を小さく保つため、すべてのソースを含む完全な帰属表示は about のみから取得できます。

セットアップ

pnpm install
cp .dev.vars.example .dev.vars   # MCP_SECRET: the one in ../opencidian-api/.dev.vars
pnpm test && pnpm typecheck

ローカルの opencidian-api に接続する場合は、そこで wrangler dev を実行してから、ここで pnpm dev を実行します。デプロイ済み API に接続する場合は、wrangler.mcp.jsonc の一時コピーで API サービスバインディングに "remote": true を設定します（コミットしないでください）。その後、pnpm exec wrangler dev -c <copy> --port 8788 を実行します。

評価：pnpm eval --url http://localhost:8788/mcp（evals/questions.md）。

デプロイ

main へのプッシュ時（.github/workflows/deploy.yml、リポジトリシークレット CLOUDFLARE_API_TOKEN および CLOUDFLARE_ACCOUNT_ID）、または pnpm exec wrangler deploy -c wrangler.mcp.jsonc でデプロイします。シークレット：MCP_SECRET（opencidian-api と同じ値）、IP_HASH_SALT、COOKIE_ENCRYPTION_KEY、DASH_PROXY_KEY（wrangler.mcp.jsonc を参照）。

ライセンス

コードは MIT ライセンスです（kit/ にはキット独自のライセンスが適用されます）。データは CC BY-SA 4.0 です。クレジットとして「OpenCidian by Perxel」とそのソースを記載してください。