Kanjialive MCP Server

Kanji Alive MCP服务器

A. 模型上下文协议 （MCP）服务器，允许您通过任何兼容MCP的AI助手（Claude、ChatGPT或其他）搜索和探索1235日文汉字。

快速入门（托管服务器）

使用此功能的最快方法是通过托管服务器。无需安装，无需配置。

在您的MCP客户端中 （Claude Desktop、Claude.ai、ChatGPT、MSTY等），使用以下URL添加一个新的远程MCP服务器：

https://kanjialive-mcp-server-production.up.railway.app/mcp

就是这样。你现在可以让你的人工智能助手利用它的知识 坎吉还活着 回答以下问题：

• “看看汉字親"
• “查找表示“父母”的汉字”
• “用onyomi阅读汉字シン"
• “给我看汉字和国音读物おや"
• “获取汉字的详细信息見,包括笔划顺序和示例”
• “查找所有一年级教授的5笔画汉字”
• “给我看看使用‘火’部首的汉字”
• “找到部首有7个笔画的汉字”
• “让我看看在母鸡（左）位置有部首的汉字”
• “AP考试第三章学习列表中有哪些汉字？”
• “跟我说说214个传统汉字偏旁”

你可以使用罗马字母或日文字母——“shin”和“ン”都可以，“oya”和“"ン”也可以。

______________________________________________________________________

本地服务器（Python、stdio）

如果你更喜欢在本地运行服务器——用于离线使用、开发或避免托管服务器——有一个Python实现可以通过stdio进行通信。

先决条件

• Python 3.10或更高版本
• 紫外线 包管理器
• RapidAPI密钥（可用免费层）

1.获取RapidAPI密钥

1. 访问 Kanji Alive API在RapidAPI上
2. 注册一个免费帐户
3. 订阅免费套餐
4. 复制API密钥

2.克隆和安装

git clone https://github.com/kanjialive/kanjialive-mcp-server.git
cd kanjialive-mcp-server/ka-mcp-local
uv sync

3.配置您的MCP客户端

将服务器添加到MCP客户端的配置文件中：

Claude桌面配置位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Kanji Alive": {
      "command": "/path/to/kanjialive-mcp-server/ka-mcp-local/.venv/bin/python",
      "args": ["/path/to/kanjialive-mcp-server/ka-mcp-local/kanjialive_mcp.py"],
      "env": {
        "RAPIDAPI_KEY": "your_api_key_here"
      }
    }
  }
}

替换 /path/to/kanjialive-mcp-server 使用克隆存储库的实际路径。

4.重新启动客户端

重新启动MCP客户端以使更改生效。

______________________________________________________________________

发展

项目结构

ka-mcp-local/               # Python stdio server
  ├── kanjialive_mcp.py      # Single-file MCP server
  ├── data/japanese-radicals.json
  └── pyproject.toml

ka-mcp-hosted/               # TypeScript HTTP server (see its own README)
  ├── src/
  ├── src/data/japanese-radicals.json
  └── package.json

extras/                      # Development resources
  └── tests/                 # Pytest test suite (102 tests)

运行测试

# From repository root
uv sync --all-extras

# Run all tests
PYTHONPATH=ka-mcp-local uv run pytest extras/tests/ -v

# Run a specific test file
PYTHONPATH=ka-mcp-local uv run pytest extras/tests/test_validators.py -v

托管服务器开发

看 ka-mcp-hosted/README.md 获取TypeScript服务器的构建、测试和部署说明。

高级搜索API参数

对于在服务器上工作或直接集成的开发人员，高级搜索工具接受以下筛选参数（所有参数都是可选的，至少需要一个）：

API 文档

• Kanji Alive API文档
• Rapidapi终点

信用

阿诺·博斯和 克劳德代码 （人类学）。

许可证