言溪题库 MCP 工具

这是一个用于言溪（https://tk.enncy.cn/）的题库。开发的 MCP（模型上下文协议）服务器允许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 描述

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

• 端点：https://tk.enncy.cn/query
• 方法：GET
• 参数：
  • 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（模型上下文协议）2024-11-05
• 通信：通过stdio的JSON-RPC
• 依赖：仅使用Python标准库
  • json：JSON处理
  • urllib：HTTP请求
  • sys：标准输入/输出
  • pathlib：文件路径处理

许可证

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

更新日志

v1.0.0 (225-11-14)

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