# 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. Look up Chinese words and characters with Hán Việt, pinyin and Vietnamese meanings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://opencidian-mcp.perxel.com/llms.txt
- **Repository:** https://github.com/opencidian/opencidian-mcp
- **MCP Registry name:** io.github.OpenCidian/opencidian
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http opencidian https://opencidian-mcp.perxel.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://opencidian-mcp.perxel.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "opencidian": {
      "url": "https://opencidian-mcp.perxel.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "opencidian": {
      "type": "http",
      "url": "https://opencidian-mcp.perxel.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "opencidian": {
      "serverUrl": "https://opencidian-mcp.perxel.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "opencidian": {
      "type": "http",
      "url": "https://opencidian-mcp.perxel.com/mcp"
    }
  }
}
```

## Tools

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

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

---
Source: https://ai-powered.com/mcp/opencidian-open-chinese-vietnamese-dictionary-han-viet-pinyi
