Yomitan MCP Server

Yomitan MCP服务器

模型上下文协议（MCP）服务器，为AI代理提供对本地Yomitan词典数据库的直接访问。

概述

此MCP服务器连接到Yomitan浏览器扩展的现有Native Messaging HTTP API（通常在 localhost:19633).它允许任何兼容MCP的客户端（如OpenClaw、Claude Desktop或Cursor）立即、完全离线执行丰富的词典查找，而无需任何浏览器自动化。

由...管理 GoRakuDo.

功能（MCP工具）

服务器公开了6个工具：

1. lookup --搜索一个词汇，并返回定义、阅读材料和标签。（针对AI环境进行了优化）
2. kanji --搜索单个汉字的详细信息。
3. tokenize --将日语句子解析为标记和词典条目。
4. anki_discover — （v1.2.0中的新功能） 自动检测哪些Anki字段标记（如 {expression}, {glossary})在您的特定Yomitan设置中有效。
5. anki_fields --根据您的Yomitan模板生成填充的Anki抽认卡字段。
6. status --检查Yomitan后端的连接状态和版本。

先决条件

1. Yomitan浏览器扩展 安装在Chrome/Firefox中。
2. 本地消息传递 在Yomitan启用。
3. API约米坦 在Yomitan设置中启用：

- 前往Yomitan设置->高级。 - 启用“Yomitan API”（确保服务器URL为 http://127.0.0.1:19633).

1. Node.js （v18+）已安装。

用法

您可以直接使用以下命令运行此MCP服务器 npx （无需安装）：

npx yomitan-mcp-server

使用MCP客户端（Claude Desktop、Cursor、OpenClaw等）

将以下配置添加到MCP客户端的配置文件中（例如。， mcp_config.json, claude_desktop_config.json):

{
  "mcpServers": {
    "yomitan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "yomitan-mcp-server@latest"
      ]
    }
  }
}

Anki集成

使用 anki_fields 有效地：

1. 在Yomitan设置->Anki->“配置Anki卡格式…”中配置您的Anki笔记类型和字段映射。
2. 使用 anki_discover 首先查看哪些标记（例如。， expression, reading, glossary, single-glossary-DictionaryName)在您的设置中可用。
3. 如果遇到HTTP 500错误，请确保使用通过以下方式找到的正确标记名称 anki_discover.

安全与隐私

• 所有查找都完全在您的计算机上本地执行。
• 此MCP服务器不向外部服务器发送数据。
• 默认的HTTP API严格按照 localhost.

故障排除

• 连接被拒绝(ECONNREFUSED)：确保带有Yomitan的浏览器正在运行。检查是否在扩展的高级设置中启用了“启用Yomitan API”。
• anki_fields中的HTTP 500错误：这通常意味着标记名称无效或未映射。跑 anki_discover 以验证您可用的标记。
• 权限不足：确保为您的浏览器正确安装了本机消息组件。您可以在“API”下的Yomitan设置页面中对此进行测试。

______________________________________________________________________

建造于 GoRakuDo。根据Mozilla公共许可证版本2.0许可。