opencidian avatar

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

opencidian/opencidian-mcp

Open Chinese-Vietnamese dictionary by Perxel: Hán Việt, pinyin, meanings, characters. Cited.

tools
7
transport
HTTP
last updated
Nov 10, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

lookupHanzi, pinyin (with or without tones) or Vietnamese; `by` forces the reading, `limit` 1-50.

Hanzi, pinyin (with or without tones) or Vietnamese; `by` forces the reading, `limit` 1-50.

No parameter schema in public metadata yet.

get_characterHán Việt, pinyin, radical, parts, etymology, strokes, traditional forms.

Hán Việt, pinyin, radical, parts, etymology, strokes, traditional forms.

No parameter schema in public metadata yet.

words_withWords of 2+ characters containing it, HSK words first.

Words of 2+ characters containing it, HSK words first.

No parameter schema in public metadata yet.

search_meaningVietnamese (default) or English meaning → candidate Chinese words.

Vietnamese (default) or English meaning → candidate Chinese words.

No parameter schema in public metadata yet.

annotate_textText (up to 2,000 characters) → words with pinyin, Hán Việt and meaning.

Text (up to 2,000 characters) → words with pinyin, Hán Việt and meaning.

No parameter schema in public metadata yet.

suggest_correctionOpens a public issue in opencidian-data (labels correction, from-ai); a maintainer turns it into a correction file. Never changes the data.

Opens a public issue in opencidian-data (labels correction, from-ai); a maintainer turns it into a correction file. Never changes the data.

No parameter schema in public metadata yet.

aboutVersion, licence, full attribution, sources with their pinned versions.

Version, licence, full attribution, sources with their pinned versions.

No parameter schema in public metadata yet.

Sponsors

Readme

opencidian-mcp

A remote MCP server for OpenCidian by Perxel: an open Chinese-Vietnamese dictionary. It is the only public way in for systems: there is no public API. Read-only except suggest_correction, which opens a public GitHub issue for a maintainer (it never changes the data); no sign-in. A Cloudflare Worker built from the Perxel MCP Kit (kit/, see STANDARD.md) over opencidian-api, which is internal: it answers 404 to every read without X-MCP-Secret, which this Worker sends over its service binding.

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

GET / lists connect instructions and every tool; GET /llms.txt says what OpenCidian is, how to connect, example questions, licence and attribution (src/lib/llms.ts); /dash is a public usage dashboard. Host: opencidian-mcp.perxel.com.

Tools


View the full README on GitHub

Details

Repository
github.com/opencidian/opencidian-mcp
Website
opencidian-mcp.perxel.com/llms.txt
Transport
HTTP
Registry
MCP registry, active