Equity-Traders MCP 服务端集合

使用说明内容(Markdown格式)

  • 项目简介 Equity-Traders 的 MCP 服务端集合实现了多种 MCP 服务器,分别暴露账户、市场数据和推送等资源和工具,便于 LLM 客户端通过统一的 MCP 协议访问与执行外部功能。
  • 主要功能点
    • accounts_server:提供账户的查询、买卖股票、变更策略等工具,以及账户相关的资源接口,支持会话与交易记录的管理。
    • market_server:提供股票价格查询工具,为交易决策提供实时或历史价格数据。
    • push_server:提供发送推送通知的工具,便于在交易执行后进行通知。
    • 统筹能力:通过 FastMCP 框架,支持标准 MCP 请求/响应、资源读取和工具调用,且可在_stdio、WebSocket、SSE 等传输模式下工作。
  • 安装步骤
    1. 将代码克隆到本地环境,并安装依赖(如 Python 版本、所需包)。
    2. 配置必要的环境变量(如 POLYGON_API_KEY、OPENAI_API_KEY、PUSHOVER_TOKEN 等)。
    3. 逐个启动 MCP 服务器:
      • 账户服务端:uv run accounts_server.py
      • 市场数据服务端:uv run market_server.py
      • 推送服务端:uv run push_server.py
    4. 若要在本地通过 MCP 客户端访问,请使用相应的客户端配置读取工具、读取资源和调用工具。
  • 服务器配置 说明:以下为适用于 MCP 客户端的启动配置信息(以 JSON 格式表示,包含服务器名称、启动命令与参数等,供客户端在连接时参考,不需要客户端直接执行)
    • accounts_server { "server_name": "accounts_server", "command": "uv", "args": ["run", "accounts_server.py"], "comment": "账户管理相关的工具与资源服务,提供查询余额、持仓、买卖、变更策略等能力" }
    • market_server { "server_name": "market_server", "command": "uv", "args": ["run", "market_server.py"], "comment": "市场数据工具,提供股票价格查询(lookup_share_price)等能力" }
    • push_server { "server_name": "push_server", "command": "uv", "args": ["run", "push_server.py"], "comment": "推送通知工具,支持将消息发送到外部通知服务" }
  • 基本使用方法
    • 启动 MCP 服务器后,客户端可以通过读取资源、调用工具来与服务器交互(例如查询账户余额、读取策略、获取股价、发送通知等)。
    • 客户端应以 JSON-RPC 的方式组织请求,服务器返回相应的 JSON-RPC 响应或通知。
    • 如需在本地测试,可使用提供的 accounts_client 等客户端模块,与 accounts_server、market_server、push_server 等服务器进行交互。

服务器信息