MCP TradingView 服务器

这是一个基于 FastMCP v2 的服务器，通过 tradingview_scraper 库提供 TradingView 技术指标和 OHLCV 数据。mcp-tradingview 控制台入口支持 Claude Desktop 或任何其他了解 MCP 协议的客户端。

快速开始

自动安装（推荐）

1. 安装 uv 和 Python 3.11+
2. 运行安装脚本：./setup.sh
   • 安装依赖项并创建虚拟环境
   • 自动配置 Claude Desktop 使用 MCP 服务器
3. 重启 Claude Desktop 加载新配置

手动安装

1. 安装 uv 和 Python 3.11+
2. uv venv --python 3.11 && source .venv/bin/activate
3. uv pip install -e .
4. 配置 Claude Desktop（见下文）

运行

• 标准输入输出（Claude 默认）：uv run mcp-tradingview
• SSE 服务：uv run mcp-tradingview --transport sse --host 0.0.0.0 --port 8000
• HTTP 服务：uv run mcp-tradingview --transport http --host 0.0.0.0 --port 8000 --path /mcp

当存在时，环境变量 FASTMCP_HOST、FASTMCP_PORT 和 FASTMCP_PATH 将覆盖绑定设置。

工具

• get_indicators(symbol, exchange="BINANCE", timeframe="1h", all_indicators=True, export_result=False) – 获取完整的 TradingView 指标快照；返回 success、symbol、exchange、timeframe 和一个 indicators 映射。
• get_specific_indicators(symbol, indicators, exchange="BINANCE", timeframe="1h", export_result=False) – 过滤完整快照到请求的键（不区分大小写），并回显 requested_indicators。
• get_historical_data(symbol, exchange="BINANCE", timeframe="1h", max_records=100, export_result=False) – 通过 Streamer 流式传输 OHLCV 蜡烛图，返回 records_collected、data 和可选的 export_file。

资源与导出

• 资源 indicators/{symbol} 使用 get_indicators 默认值生成格式化的指标报告。
• 当 export_result=True 时，JSON 负载将写入 export/；避免将大型存档纳入版本控制。

Claude Desktop

在 claude_desktop_config.json 中添加服务器。以下是推荐配置：

使用 Claude Code CLI（最简单）

claude mcp add tradingview -- uvx --from /absolute/path/to/mcp-tradingview-server mcp-tradingview

或者使用 uv run：

claude mcp add tradingview -- uv run mcp-tradingview --cwd /absolute/path/to/mcp-tradingview-server

手动配置

标准输入输出传输（推荐）

{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/mcp-tradingview-server", "mcp-tradingview"]
    }
  }
}

或者使用 uv run：

{
  "mcpServers": {
    "tradingview": {
      "command": "uv",
      "args": ["run", "mcp-tradingview"],
      "cwd": "/absolute/path/to/mcp-tradingview-server"
    }
  }
}

HTTP 传输

{
  "mcpServers": {
    "tradingview": {
      "command": "uv",
      "args": ["run", "mcp-tradingview", "--transport", "http", "--host", "0.0.0.0", "--port", "8001", "--path", "/mcp"],
      "cwd": "/absolute/path/to/mcp-tradingview-server"
    }
  }
}

更新配置后重启 Claude Desktop。捆绑的 CLAUDE.md 提供额外指导，模型可以在聊天时参考。

开发

• uv run pytest 在 test_server.py 中执行异步测试套件。
• 使用 logging.getLogger(__name__) 进行诊断；避免打印机密信息。
• 更新测试或文档时，参考 export/ 中捕获的固定实例。

许可

此项目按原样提供用于教育和研究目的。