OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown)
Look up Chinese words and characters with Hán Việt, pinyin and Vietnamese meanings
- Pricing
- Free
- Platforms
- API
- Runs
- Remotely
- Version
- 0.3.0
- Listing updated
- 5 days ago
About OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown)
OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown) is a free MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.
OpenCidian merges several open sources into one dataset of about 125,000 words and 14,500 characters: CC-CEDICT, CVDICT, Thiều Chửu's Hán Việt dictionary, Unihan, Make Me a Hanzi and the HSK word lists. Every field in an answer carries the source it came from, and each answer states the dataset version. A word the dictionary lacks is reported as missing instead of guessed.
Assistants can look up words in Chinese, pinyin or Vietnamese, pull a character's readings, radical, parts and etymology, list words that contain a character, search by meaning in Vietnamese or English, and annotate a passage of Chinese word by word. A word-analysis prompt template writes a study note in Vietnamese for learners.
The endpoint is hosted, needs no sign-in and is read-only except for a correction tool that opens a public GitHub issue for a maintainer to review. Data is CC BY-SA 4.0 and the code is MIT; there is no public REST API.
Install
Run in a terminal
claude mcp add --transport http opencidian https://opencidian-mcp.perxel.com/mcpAdd to Settings → Connectors → Add custom connector
https://opencidian-mcp.perxel.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"opencidian": {
"url": "https://opencidian-mcp.perxel.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"opencidian": {
"type": "http",
"url": "https://opencidian-mcp.perxel.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"opencidian": {
"serverUrl": "https://opencidian-mcp.perxel.com/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://opencidian-mcp.perxel.com/mcpEnter a Name (for example "OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"opencidian": {
"type": "http",
"url": "https://opencidian-mcp.perxel.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- lookup
- Dictionary entries for a Chinese word, pinyin syllable or Vietnamese word.
- get_character
- Readings, radical, strokes, parts and etymology of one character.
- words_with
- Words of two or more characters containing a given character.
- search_meaning
- Vietnamese or English meaning to Chinese words.
- annotate_text
- Split Chinese text into words with pinyin and meanings.
- suggest_correction
- Open a public GitHub issue proposing a correction.
- about
- Dataset version, licence and attribution.
What it does
- Sourced answers
- Each field names its source and the answer carries the dataset version.
- Character breakdown
- Hán Việt readings, radical, stroke count, parts and etymology.
- Text annotation
- Split Chinese text into words with pinyin, Hán Việt and meanings.
- Reverse search
- Find Chinese words from a Vietnamese or English meaning.
- Public corrections
- Report errors as GitHub issues for review.
- Word-analysis prompt
- Template that writes a learner's study note in Vietnamese.
Good for
- Find the Hán Việt reading of a character
- Annotate a Chinese sentence for a Vietnamese learner
- Look for common words containing one character
- Find the Chinese for a Vietnamese phrase
- Cite the dataset correctly when reusing entries
Pricing
Free
Free, no sign-in
Prices change. Check opencidian-mcp.perxel.com before you buy.
OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown) FAQ
Is it free?
Yes. It needs no sign-in.
Where does the data come from?
CC-CEDICT, CVDICT, Thiều Chửu, Unihan, Make Me a Hanzi and HSK lists, each pinned to a version.
Can the assistant change the dictionary?
No. suggest_correction only opens a public issue that a maintainer reviews.
What is the licence?
Data is CC BY-SA 4.0; code is MIT.
How long can annotated text be?
The README gives a limit of 2,000 characters.
Is OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown) free?
Yes. OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown) is free to use.
How do I add OpenCidian: open Chinese ↔ Vietnamese dictionary (Hán Việt, pinyin, character breakdown) to Claude Code?
Run this command in your terminal: claude mcp add --transport http opencidian https://opencidian-mcp.perxel.com/mcp
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.