MCP Trader Server 使用说明

项目简介

MCP Trader Server 是一个专门为股票交易者设计的 Model Context Protocol (MCP) 服务器。它通过标准化的 MCP 协议，向大型语言模型（LLM）客户端提供丰富的股票市场分析工具，帮助用户更智能地进行股票研究和交易决策。

主要功能点

股票技术分析: 提供全面的技术指标分析，包括移动平均线、动量指标、波动率指标和成交量分析，帮助用户快速了解股票的技术面貌。
相对强度分析: 计算股票相对于基准指数的相对强度，评估股票在不同时间段内的表现，辅助用户选择强势股票。
成交量分析: 分析成交量在不同价格水平的分布情况，识别重要的价格控制点和价值区域，提升对市场微观结构的理解。
图表模式识别: 自动识别股票图表中的常见模式，如双底、双顶等，并提供模式的置信度和价格目标，辅助用户进行趋势判断。
仓位大小计算: 根据用户设定的风险参数（止损价、风险金额、账户规模），计算最佳的交易仓位，帮助用户科学管理交易风险。
止损位建议: 基于技术分析，为用户提供多种止损策略建议，包括基于ATR、百分比和技术水平的止损位，辅助用户制定风险控制计划。

安装步骤

环境准备: 确保已安装 Python 3.11+，并安装 'uv' 和 'ta-lib'。如果ta-lib安装遇到问题，请参考 ta-lib官方安装指南。
获取 Tiingo API 密钥: 访问 Tiingo API 注册并获取API密钥，用于获取股票市场数据。
配置环境变量: 在项目根目录下创建 '.env' 文件，并填入你的 Tiingo API 密钥：
```
TIINGO_API_KEY=your_api_key_here
```

安装项目依赖:

uv venv --python 3.11
source .venv/bin/activate  # 或 .venv\Scripts\activate (Windows)
uv sync

启动 MCP Trader Server:

uv run mcp-trader

或者，以 HTTP 服务器模式启动（用于测试或集成其他应用）:

uv run mcp-trader --http

服务器配置

要将 MCP Trader Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以连接到此服务器。以下是 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件中。

Claude Desktop 配置文件路径:

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置信息 (JSON 格式):

{
  "mcpServers": {
    "stock-analyzer": {  // 服务器名称，客户端内唯一标识符，可自定义
      "command": "uv",  // 启动服务器的命令
      "args": [        // 命令参数
        "--directory", // 指定工作目录
        "/absolute/path/to/mcp-trader", // 替换为 mcp-trader 仓库的绝对路径
        "run",         // uv run 子命令，用于运行 Python 脚本
        "mcp-trader"  // 要运行的 Python 模块名 (mcp_trader.server)
      ],
      "env": {          // 环境变量
        "TIINGO_API_KEY": "your_api_key_here" // 确保 Tiingo API 密钥已配置
      }
    }
  }
}

注意:

请将 '/absolute/path/to/mcp-trader' 替换为 mcp-trader 仓库在您本地文件系统中的实际绝对路径。
确保 'TIINGO_API_KEY' 环境变量在服务器启动时能够正确加载，可以通过 '.env' 文件或直接在 'env' 配置中设置。
'server name' 可以自定义，例如 "stock-analyzer"，在客户端中通过此名称引用该服务器。

基本使用方法

成功配置 MCP Trader Server 后，您可以在 MCP 客户端中，通过自然语言指令调用服务器提供的工具。例如，在 Claude Desktop 中，您可以这样提问：

Analyze the technical setup for NVDA

服务器将调用 'analyze-stock' 工具，分析 NVDA 股票的技术面，并将分析结果返回给 Claude Desktop。您还可以尝试使用其他工具，例如：

Calculate the relative strength of AAPL compared to SPY
Suggest stop loss levels for META
What is the volume profile for MSFT?

通过组合不同的工具和指令，您可以利用 MCP Trader Server 进行更深入的股票市场分析和交易策略研究。

关键词