mcp_zhitou_server

🌟 主要特性

• MCP 标准实现: 通过标准输入/输出 (stdio) 与兼容 MCP 的客户端进行 JSON-RPC 通信。
• 直连 Zhitou API: 无缝对接智兔数服提供的丰富沪深市场数据接口。
• Python 编写: 代码简洁易懂，方便二次开发和扩展。
• 即插即用: 提供清晰的配置指南，轻松在 Cursor 或 Cline 中启用。
• 工具化封装: 将常用的 Zhitou API 封装成 MCP 工具，方便 AI 调用。
• 基础日志与错误处理: 包含必要的日志记录和异常处理，方便调试。

🛠️ 快速开始

1. 环境准备 (Prerequisites)

• Python: 确认你的环境安装了 Python (推荐 3.8 或更高版本)。
• Requests 库: 我们需要它来调用 API。打开你的终端/命令行，运行： bash pip install requests
• 智兔 API Token: 你必须拥有一个智兔数服的账号，并获取你的 API Token。
• MCP 客户端: 安装 Cursor 或 Cline。

2. 获取代码 & 配置 Token

• 下载本仓库唯一文件 mcp_zhitou_server.py
• 配置你的 API Token: 打开主脚本文件 mcp_zhitou_server.py，找到并替换 ZHITU_TOKEN 为你的真实 API Token。

3. 配置 MCP 客户端

• 如果你用 Cline:
  1. 打开 Cline。
  2. 进入设置，找到 MCP Servers 管理界面。
  3. 添加一个新的 MCP Server，填写名称和命令路径。
• 如果你用 Cursor:
  1. 在项目根目录下创建 .cursor 文件夹和 mcp.json 文件。
  2. 将配置 JSON 粘贴到 mcp.json 中，并修改脚本路径。

4. 开始使用

打开 Cursor 或 Cline 聊天窗口，用自然语言调用工具查询数据。

🔧 可用工具列表 (Tools Available)

• get_stock_list: 获取基础 A 股股票列表。
• get_new_stock_calendar: 获取新股日历。
• get_company_profile: 获取指定股票代码的上市公司简介。
• get_capital_daily_trend: 获取指定股票代码的每日资金流入趋势。
• get_all_announcements: 获取指定股票代码的历史所有公告列表。

🚀 如何扩展？

1. 查阅智兔 API 文档，找到想添加功能的 API 端点。
2. 编写 Python 函数并注册到 TOOLS 字典中。
3. 更新客户端配置（如需要）。
4. 重启 MCP 服务。

许可证

该项目遵循 MIT 开源许可条款。