适合谁
- 需要编程访问 Tiingo 财务数据的开发者和量化分析师。
- 希望将金融数据集成到 MCP 客户端（如 Claude Desktop）的用户。
- 需要自动化获取股票、新闻、外汇和基本面数据的工作流。
S
42FMRS · D
该服务器提供了对 Tiingo API 的封装，覆盖多种金融数据端点，但需要用户自备 API 密钥。代码结构清晰，易于扩展，但官方许可状态不明确（NOASSERTION）。适合需要编程访问 Tiingo 数据的开发者。
Stock Trade MCP Server 是一个模型上下文协议（MCP）服务器，将 Tiingo API 的各种端点暴露为工具。它允许通过 MCP 协议以编程方式访问财务数据，包括股票价格、新闻、外汇、基本面和公司行动。需要 Node.js（v18 或更高版本）、npm 和 Tiingo API 密钥。
工具能力
get_end_of_day_prices
获取给定股票代码的日终价格，可指定日期范围和重采样频率。
get_news
从 Tiingo 获取新闻文章，支持多种过滤选项，如股票代码、标签、来源等。
get_forex_prices
获取给定货币对的历史日内外汇价格，可指定日期范围和频率。
get_forex_top_of_book
获取一个或多个货币对的实时外汇最优买卖盘/最后数据。
get_fundamentals_definitions
获取可用的基本面指标及其定义。
get_fundamentals_statements
获取给定股票的历史基本面报表数据（资产负债表、损益表、现金流量表、概览）。
get_fundamentals_daily_metrics
获取给定股票的每日基本面指标。
get_fundamentals_meta
获取公司的基本面元数据。
get_dividend_distributions
获取给定股票的历史股息和分配数据。
get_dividend_yield
获取给定股票的历史股息收益率数据。
get_splits
获取给定股票的历史拆股数据。
安装接入
- 克隆仓库并进入项目目录。
- 运行
npm install安装依赖。 - 在 Tiingo 网站注册账户并获取 API 令牌（访问 https://www.tiingo.com/account/api/token）。
- 在 MCP 客户端配置中设置
TIINGO_API_TOKEN环境变量。 - 运行
npm run build构建服务器。 - 配置 MCP 客户端以 stdio 传输方式运行服务器。
claude_desktop_config.json
{
"mcp-tiingo": {
"transportType": "stdio",
"command": "node",
"args": [
"/path/to/mcp-tiingo/build/index.js"
],
"env": {
"TIINGO_API_TOKEN": "YOUR_API_KEY_HERE"
}
}
}
选型与风险
不适合谁
- 没有 Tiingo API 密钥的用户（必须注册并获取令牌）。
- 需要实时流式报价的用户（该服务器仅提供 REST 端点）。
- 需要除了 Tiingo 之外其他数据源的用户。
所需权限
- 需要网络访问权限以调用 Tiingo API。
- 需要环境变量 `TIINGO_API_TOKEN` 来认证。
- 需要本地文件系统权限来读取构建后的 JavaScript 文件（通常是 `build/index.js`）。
风险与副作用
- Tiingo API 密钥泄露风险：请妥善保管，避免在公共配置中暴露。
- API 调用可能产生费用：根据 Tiingo 的使用条款，可能需要付费。
- 依赖第三方服务：Tiingo 的可用性和数据准确性可能变化。
- 错误处理不完善：如果 API 密钥无效或请求失败，服务器可能返回错误。
常见排障
- 确保 Tiingo API 密钥有效，并在环境变量中正确设置。
- 检查 Node.js 版本是否不低于 v18。
- 确保 `npm install` 和 `npm run build` 成功执行。
- 检查 MCP 客户端配置中的命令和参数路径是否正确。
- 查看服务器日志以获取错误详细信息。
使用场景
获取股票的历史日终价格，用于趋势分析和回测。
检索最新财经新闻，辅助投资决策。
查询外汇历史价格和实时报价，用于汇率分析。
获取公司的基本面报表和指标，进行价值投资分析。
跟踪股息、拆股等公司行动信息。
支持客户端
Claude Desktop完整支持