Skip to content
MCP server

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

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://opencidian-mcp.perxel.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "opencidian": {
      "url": "https://opencidian-mcp.perxel.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter 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.

Full Grok Bot setup guide

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.

How AIPoweredBot checks servers