Skip to main content
Glama
wshobson

MCP Trader Server

by wshobson

MCP 交易服务器

铁匠徽章

面向股票交易者的模型上下文协议 (MCP) 服务器。

特征

工具

该服务器提供以下股票分析和交易工具:

  • analyze-stock :对给定的股票代码进行技术分析

    • 必需参数: symbol (字符串,例如“NVDA”)

    • 返回全面的技术分析,包括:

      • 移动平均趋势(20、50、200 SMA)

      • 动量指标(RSI、MACD)

      • 波动率指标(ATR、ADRP)

      • 成交量分析

  • 相对强度:计算股票相对于基准的相对强度

    • 必需参数: symbol (字符串,例如“AAPL”)

    • 可选参数: benchmark (字符串,默认值:“SPY”)

    • 返回多个时间范围(21、63、126、252 天)的相对强度指标

    • 包括股票与基准之间的表现比较

  • 成交量分布:按价格分析成交量分布

    • 必需参数: symbol (字符串,例如“MSFT”)

    • 可选参数: lookback_days (整数,默认值:60)

    • 返回成交量概况分析,包括:

      • 控制点(POC)- 交易量最高的价格水平

      • 值区域(体积范围的 70%)

      • 最高成交量价格水平

  • 检测模式:识别价格数据中的图表模式

    • 必需参数: symbol (字符串,例如“AMZN”)

    • 返回检测到的图表模式以及置信度和价格目标

  • 仓位规模:根据风险参数计算最佳仓位规模

    • 必需参数:

      • symbol (字符串,例如“TSLA”)

      • stop_price (数字)

      • risk_amount (数字)

      • account_size (数字)

    • 可选参数: price (数字,默认值:当前价格)

    • 返回建议的头寸规模、美元风险和潜在利润目标

  • suggest-stops :根据技术分析建议止损水平

    • 必需参数: symbol (字符串,例如“META”)

    • 根据以下内容返回多个止损建议:

      • 基于 ATR 的止损(1x、2x、3x ATR)

      • 基于百分比的停止(2%、5%、8%)

      • 技术水平(移动平均线、近期波动低点)

技术分析能力

该服务器利用了几个专门的分析模块:

  • 技术分析:核心技术指标和趋势分析

    • 移动平均线(SMA 20、50、200)

    • 动量指标(RSI、MACD)

    • 波动率指标(ATR,平均每日波动百分比)

    • 成交量分析(20天平均成交量)

  • RelativeStrength :比较性能分析

    • 多时间框架相对强弱评分(21、63、126、252 天)

    • 与基准指数的表现比较

    • 优异/不佳表现分类

  • VolumeProfile :高级体积分析

    • 价格水平成交量分布

    • 控制点(POC)识别

    • 值面积计算(体积的 70%)

  • PatternRecognition :图表模式检测

    • 支撑/阻力位

    • 常见图表形态(头肩、双顶/双底等)

    • 对检测到的模式进行置信度评分

  • 风险分析:仓位规模和风险管理

    • 基于风险的头寸调整

    • 多种止损策略

    • R倍数利润目标计算

数据源

服务器使用Tiingo API获取市场数据:

  • 历史每日 OHLCV 数据

  • 调整价格以进行准确的回溯测试

  • 默认最多 1 年的历史数据

Related MCP server: Trading Simulator MCP Server

设置

先决条件

环境变量

创建.env文件:

TIINGO_API_KEY=your_api_key_here

通过 Smithery 安装

要通过Smithery自动安装 Claude Desktop 的 Trader:

npx -y @smithery/cli install mcp-trader --client claude

这将:

  1. 安装 MCP Trader 服务器

  2. 使用您的 Tiingo API 密钥进行配置

  3. 设置 Claude Desktop 集成

Smithery 配置

该服务器包含一个smithery.yaml配置文件,该文件定义:

  • 所需配置参数(Tiingo API 密钥)

  • 启动 MCP 服务器的命令函数

  • 与 Claude Desktop 集成

您可以通过编辑smithery.yaml文件来自定义 Smithery 配置。

安装

uv venv --python 3.11 source .venv/bin/activate # On Windows: .venv\Scripts\activate uv sync

Docker 部署

该项目包含一个用于容器化部署的Dockerfile:

# Build the Docker image docker build -t mcp-trader . # Run the container with your API key docker run -e TIINGO_API_KEY=your_api_key_here -p 8000:8000 mcp-trader

要在 HTTP 服务器模式下运行容器:

docker run -e TIINGO_API_KEY=your_api_key_here -p 8000:8000 mcp-trader uv run mcp-trader --http

配置

克劳德桌面应用程序

在 MacOS 上: ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

开发配置:

{ "mcpServers": { "stock-analyzer": { "command": "uv", "args": [ "--directory", "/absolute/path/to/mcp-trader", "run", "mcp-trader" ] "env": { "TIINGO_API_KEY": "your_api_key_here" } } } }

发展

构建并运行

uv build uv run mcp-trader

HTTP 服务器模式

该服务器还可以作为独立的 HTTP 服务器运行,以进行测试或与其他应用程序集成:

uv run mcp-trader --http

这将在http://localhost:8000上启动一个 HTTP 服务器,其端点如下:

  • GET /list-tools :返回可用工具及其模式的列表

  • POST /call-tool :使用提供的参数执行工具

    • 请求主体格式:

      { "name": "analyze-stock", "arguments": { "symbol": "AAPL" } }
    • 返回内容项数组(文本、图像等)

调试

使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-trader run mcp-trader

示例用法

在 Claude Desktop 中:

Analyze the technical setup for NVDA

服务器将返回技术分析摘要,包括趋势状态、动量指标和关键指标。

NVDA技术分析

依赖项

查看 pyproject.toml 以获取完整的依赖项列表:

- aiohttp >=3.11.11 - mcp >=1.2.0 - numpy ==1.26.4 - pandas >=2.2.3 - pandas-ta >=0.3.14b0 - python-dotenv >=1.0.1 - setuptools >=75.8.0 - ta-lib >=0.6.0

贡献

欢迎为 MCP Trader 做出贡献!以下是一些您可以做出贡献的方式:

  • 添加新工具:实施额外的技术分析工具或交易策略

  • 改进现有工具:提高现有工具的准确性或性能

  • 添加数据源:集成其他市场数据提供商

  • 文档:改进文档或添加示例

  • 错误修复:修复问题或改进错误处理

开发工作流程

  1. 分叉存储库

  2. 创建功能分支( git checkout -b feature/amazing-feature

  3. 提交您的更改( git commit -m 'Add some amazing feature'

  4. 推送到分支( git push origin feature/amazing-feature

  5. 打开拉取请求

未来计划

MCP Trader 项目计划进行多项增强:

  • 投资组合分析:分析和优化投资组合的工具

  • 回溯测试:利用历史数据测试交易策略的能力

  • 情绪分析:与新闻和社交媒体情绪数据的整合

  • 期权分析:分析期权策略和定价的工具

  • 实时数据:支持实时市场数据馈送

  • 自定义策略:用于实施和测试自定义交易策略的框架

  • 警报:价格和技术指标警报的通知系统

进一步阅读

通过这些详细的博客文章了解有关该项目的更多信息:

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wshobson/mcp-trader'

If you have feedback or need assistance with the MCP directory API, please join our Discord server