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

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

远程服务

opencidian-mcp.perxel.com其他01 天前更新

代码仓库访问官网

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

OpenCidian 是 Perxel 提供的开放中越词典 MCP 服务，供需要汉越音、拼音、释义和汉字分析的系统使用。它是该词典唯一的公开访问入口；查询带有字段来源和版本信息，纠错建议则通过创建公开 GitHub issue 提交。

主要功能

01按汉字、拼音或越南语查询
02查看汉字读音、部件与字源
03查找包含指定汉字的词语
04按越南语或英语释义搜索
05为文本添加读音与释义标注
06提交纠错建议为 GitHub issue

适用场景

01查询中文词语的越南语释义
02分析汉字的部件与读音
03为中文文本生成词语标注
04报告词典数据中的疑似错误

MCP 相关

OpenCidian 通过无状态 Streamable HTTP 提供远程 MCP 服务，是词典唯一的公开访问方式。查询工具为只读；纠错工具只会在 opencidian-data 中创建公开 issue，不会直接修改数据。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://opencidian-mcp.perxel.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http opencidian-opencidian https://opencidian-mcp.perxel.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"opencidian-opencidian":{"type":"http","url":"https://opencidian-mcp.perxel.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"opencidian-opencidian":{"type":"http","url":"https://opencidian-mcp.perxel.com/mcp"}}}在 VS Code 中打开

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

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"opencidian-opencidian":{"serverUrl":"https://opencidian-mcp.perxel.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

opencidian-mcp

由 Perxel 提供的 OpenCidian 远程 MCP 服务：一部开放的中越词典。这是系统唯一的公开接入方式：没有公开 API。除 suggest_correction 外均为只读；该工具会为维护者创建公开的 GitHub issue（不会更改数据）；无需登录。此服务是基于 opencidian-api 构建的 Cloudflare Worker，使用 Perxel MCP Kit（kit/，参见 STANDARD.md）。opencidian-api 为内部服务：没有 X-MCP-Secret 的所有读取请求都会收到 404，而此 Worker 会通过其服务绑定发送该密钥。

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}`	汉越音、拼音、部首、部件、词源、笔画、繁体字形。
`words_with`	`GET /v1/words-with/{char}`	包含该字的 2 个或更多字符的词语；HSK 词语优先。
`search_meaning`	`GET /v1/search`	越南语（默认）或英语释义 → 候选中文词语。
`annotate_text`	`POST /v1/annotate`	文本（最多 2,000 个字符）→ 带拼音、汉越音和释义的词语。
`suggest_correction`	`POST /v1/corrections`	在 opencidian-data 中创建公开 issue（标签为 `correction`、`from-ai`）；维护者会将其整理为更正文件。不会更改数据。所有 MCP 调用方合计每分钟最多 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）。