项目简介

Portfolio Service MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 应用提供全面的金融市场数据和交易功能。它集成了流行的券商 API（Interactive Brokers 和 TradeStation）以及 TradingView 的市场扫描能力，通过标准化的 MCP 协议，使得 LLM 客户端能够安全、便捷地访问和利用这些金融服务。

主要功能点

多券商支持: 无缝集成 Interactive Brokers (IBKR) 和 TradeStation 两个主流券商平台。
全面的市场数据: 提供实时的和历史的市场数据访问接口。
高级交易功能: 支持程序化交易执行和订单管理。
新闻整合: 集成市场新闻资讯，提供新闻标题和全文内容。
期权交易支持: 支持访问期权链和管理期权仓位。
TradingView 集成: 内置 TradingView 强大的市场扫描工具。
账户资源访问: 以资源形式暴露账户摘要、投资组合和订单信息。
工具调用: 提供丰富的工具，如获取市场数据、下单、修改订单、市场扫描等。

安装步骤

克隆仓库：

git clone https://github.com/MCP-Mirror/itay1542_brokers-mcp
cd itay1542_brokers-mcp

安装依赖：项目使用 'uv' 进行依赖管理。请确保已安装 'uv'。然后在项目根目录下运行：
```
uv sync
```

配置环境变量：根据 'README.md' 中的说明，配置券商 API 的密钥和账户 ID 等环境变量。例如，TradeStation 和 Interactive Brokers 的配置：

# TradeStation 配置
TRADESTATION_API_KEY="your_api_key"
TRADESTATION_API_SECRET="your_api_secret"
TS_REFRESH_TOKEN="your_refresh_token"
TS_ACCOUNT_ID="your_account_id"

# Interactive Brokers 配置
IBKR_ACCOUNT_ID="your_account_id"

请参考 setup guide 获取 API 凭证的详细步骤。

服务器配置 (MCP 客户端配置)

以下 JSON 配置信息用于配置 MCP 客户端 (例如 Claude Desktop) 连接到 Portfolio Service MCP Server。请将 '<path_to_project>' 替换为项目在您本地的实际路径。

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

'server name': 'portfolio_service' (服务器名称，客户端用于标识，可自定义)
'command': 'uv' (启动服务器的命令，这里使用 'uv' 运行项目)
'args': 启动参数列表
- '--directory': '<path_to_project>/itay1542_brokers-mcp/portfolio_service' (指定项目 'portfolio_service' 目录的路径，请替换为实际路径)
- 'run': ('uv run' 命令用于运行项目)
- 'portfolio_service': ('portfolio_service' 可能是项目入口点或脚本名称)

基本使用方法

启动 MCP 服务器：打开终端，导航到项目根目录 'itay1542_brokers-mcp'，并根据上述服务器配置中的 'command' 和 'args' 启动服务器。例如，使用 'uv' 启动的命令可能是：
```
uv --directory portfolio_service run portfolio_service
```
配置 MCP 客户端：在您的 MCP 客户端 (如 Claude Desktop) 中，根据上述 “服务器配置” 部分的 JSON 信息进行配置，确保 'command' 和 'args' 配置正确，并且 '<path_to_project>' 已替换为实际路径。
使用 MCP 客户端与服务器交互：客户端成功连接到服务器后，即可通过客户端界面或指令，利用服务器提供的 Resources (资源) 和 Tools (工具) 访问账户信息、市场数据，或执行交易操作。具体可用的 Resources 和 Tools 及其使用方法，请参考项目代码和 'README.md' 文档。

开发调试

项目提供了 MCP Inspector 工具的集成，方便开发者进行调试和监控。具体使用方法请参考 'README.md' 中关于 “Debugging” 的部分。

关键词