关键词

股票交易自动化交易量化交易金融数据TradeStation API

使用说明

项目简介

brokers-mcp 项目实现了一个 Model Context Protocol (MCP) 服务器，专注于为 LLM 应用提供金融交易能力。它目前集成了 TradeStation API，允许用户通过自然语言指令，利用 LLM 客户端调用预设的工具来查询股票市场数据、进行交易操作以及获取账户信息。

主要功能点

  • TradeStation API 集成: 目前支持 TradeStation 交易平台的 API 接口，未来可能扩展支持更多券商。
  • 工具 (Tools) 提供: 提供了一系列基于 TradeStation API 的工具，包括：
    • 'tradestation_get_bars': 获取股票/期货/期权的历史K线数据。
    • 'tradestation_place_buy_order': 下单买入股票/期货/期权。
    • 'tradestation_place_sell_order': 下单卖出股票/期货/期权。
    • 'tradestation_get_positions': 查询当前持仓信息。
    • 'tradestation_get_balances': 查询账户资金余额。
  • 资源 (Resources) 访问: 提供对账户余额和持仓信息的资源访问，允许 LLM 应用以标准化的方式获取这些数据。
  • 标准 MCP 协议: 遵循 MCP 协议标准，易于与任何兼容 MCP 协议的 LLM 客户端集成。

安装步骤

  1. 克隆仓库: 首先将 GitHub 仓库 'brokers-mcp' 克隆到本地。
  2. 安装依赖: 进入项目根目录 'brokers-mcp'，运行 'uv sync' 命令安装项目依赖。 (请确保已安装 uv 工具)
  3. 配置环境变量: 根据 TradeStation API 的要求，配置以下环境变量：
    • 'TRADESTATION_API_KEY': 你的 TradeStation API Key
    • 'TRADESTATION_API_SECRET': 你的 TradeStation API Secret
    • 'TS_REFRESH_TOKEN': 你的 TradeStation Refresh Token
    • 'TS_ACCOUNT_ID': 你的 TradeStation 账户 ID 获取这些环境变量的步骤，请参考 这里。

服务器配置

要将 brokers-mcp 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要编辑客户端的配置文件 (例如 Claude Desktop 的 'claude_desktop_config.json')，添加如下服务器配置信息。请注意将 '<path_to_project>' 替换为 brokers-mcp 项目在您本地的实际路径。

"mcpServers": {
  "portfolio_service": {
    "command": "uv",
    "args": [
      "--directory",
      "<path_to_project>/portfolio_service",
      "run",
      "portfolio_service"
    ]
  }
}

配置参数说明:

  • 'server name': 'portfolio_service' - 服务器名称，客户端用此名称来标识和调用该 MCP 服务器。
  • 'command': 'uv' - 启动服务器的命令，这里使用 'uv' (一个 Python 包安装和运行工具)。
  • 'args': 启动参数列表，包括：
    • '--directory': '<path_to_project>/portfolio_service' - 指定服务器代码所在的目录。
    • 'run': 告知 'uv' 运行指定的 Python 包。
    • 'portfolio_service': 要运行的 Python 包名称，对应项目中的 'portfolio_service' 包。

基本使用方法

  1. 启动服务器: 配置完成后，MCP 客户端（如 Claude Desktop）应该能够根据配置启动 'brokers-mcp' 服务器。
  2. 通过客户端调用工具和资源: 在 LLM 客户端中，你可以指示 LLM 使用 'portfolio_service' 服务器提供的工具和资源。例如，你可以指示 Claude 使用 'tradestation_get_bars' 工具查询 AAPL 股票的K线数据，或者使用 'get_balances' 资源查看账户余额。具体的调用方式取决于 LLM 客户端的功能和界面。
  3. 调试: 如果遇到问题，可以使用 MCP Inspector 工具进行调试，具体方法参考仓库 README 文档。

注意: brokers-mcp 服务器目前仅支持 TradeStation API 的部分功能，且 TradeStation API 本身为付费服务，使用前请确保您拥有 TradeStation 账户和 API 访问权限。

信息

分类

商业系统

访问项目