Enncy Tk MCP

言溪题库 MCP 工具

这是一个为言溪题库（https://tk.enncy.cn/）开发的 MCP (Model Context Protocol) 服务器，允许 AI 助手（如 Claude Code）直接查询题库中的题目答案。

特性

• 纯 Python 标准库实现，无需安装任何额外依赖
• 支持 Token 管理和持久化存储
• 提供题目搜索功能，支持标题、选项和类型过滤
• 完整的错误处理和用户友好的响应

安装和配置

1. 确保 Python 环境

确保系统已安装 Python 3.6 或更高版本：

python3 --version

2. 赋予执行权限

chmod +x ~/Downloads/EnncyTkMCP/enncy-query-mcp.py

3. 配置 Claude Code

在 Claude Code 中添加 MCP 服务器配置。打开 Claude Code 的配置文件，添加以下内容：

macOS/Linux: ~/.config/claude-code/mcp.json Windows: %APPDATA%\claude-code\mcp.json

{
  "mcpServers": {
    "enncy-query": {
      "command": "python3",
      "args": [
        "~/Downloads/EnncyTkMCP/enncy-query-mcp.py"
      ],
      "description": "言溪题库搜索工具 - 提供题目搜索和答案查询功能"
    }
  }
}

请将路径替换为你实际存放文件的位置。建议将文件放在家目录下便于管理。

4. 重启 Claude Code

配置完成后，重启 Claude Code 以加载 MCP 服务器。

使用方法

1. 设置 Token

首次使用前，需要设置言溪题库的访问 Token：

请帮我设置言溪题库的 token: your_token_here

Token 会被安全地存储在用户主目录的 .yanxi_tk_token 文件中。

2. 搜索题目

设置 Token 后，就可以开始搜索题目了：

基础搜索（仅提供题目标题）：

帮我在言溪题库中搜索："中国的首都是哪里"

提供选项的搜索：

搜索题目："以下哪个是 Python 的关键字"
选项：
A. class
B. function
C. method
D. variable

指定题目类型：

搜索判断题："地球是圆的"

工具说明

set_token

设置言溪题库的用户 Token（访问凭证）。

参数：

• token (必需): 言溪题库的用户 Token

示例响应：

{
  "success": true,
  "message": "Token 设置成功",
  "token": "abcd1234...xyz9"
}

search_question

在言溪题库中搜索题目答案。

参数：

• title (必需): 题目标题或题干
• options (可选): 题目选项，多个选项用换行或特定分隔符分隔
• type (可选): 题目类型，如：单选、多选、判断等

成功响应（code = 0）：

{
  "success": true,
  "answer": "北京",
  "message": "成功找到答案"
}

其他响应：

{
  "success": true,
  "question": "题目内容",
  "answer": "答案内容",
  "ai": "AI 生成的补充信息（如果有）"
}

错误响应：

{
  "success": false,
  "error": "错误信息"
}

配置文件

Token 存储在用户主目录下的 .yanxi_tk_token 文件中：

• macOS/Linux: ~/.yanxi_tk_token
• Windows: %USERPROFILE%\.yanxi_tk_token

如需更换 Token，可以：

1. 使用 set_token 工具重新设置
2. 或直接编辑该文件

API 说明

本工具调用言溪题库的查询接口：

• Endpoint: https://tk.enncy.cn/query
• Method: GET
• Parameters:

- token: 用户凭证 - title: 题目标题 - options: 题目选项（可选） - type: 题目类型（可选）

故障排查

Token 未设置

如果看到 "未设置 Token" 错误，请先使用 set_token 工具设置 Token。

网络错误

如果遇到网络错误，请检查：

1. 网络连接是否正常
2. 是否可以访问 https://tk.enncy.cn/
3. Token 是否有效

权限错误

如果遇到文件权限错误：

chmod +x ~/Downloads/EnncyTkMCP/enncy-query-mcp.py
chmod 600 ~/.yanxi_tk_token

安全提示

• Token 是敏感信息，请妥善保管，不要分享给他人
• Token 存储文件具有用户私有权限
• 本工具仅用于学习交流，请遵守言溪题库的使用条款

技术细节

• 协议: MCP (Model Context Protocol) 2024-11-05
• 通信: JSON-RPC over stdio
• 依赖: 仅使用 Python 标准库

- json: JSON 处理 - urllib: HTTP 请求 - sys: 标准输入输出 - pathlib: 文件路径处理

许可证

本项目仅供学习和研究使用。

更新日志

v1.0.0 (2025-11-14)

• 初始版本发布
• 实现 set_token 和 search_question 工具
• 支持 Token 持久化存储
• 完整的错误处理机制