适合谁
- 已拥有 Twelve Data 账户、需要在 AI 助手中查询金融市场数据的个人或团队
- 希望免安装、通过云端连接器快速接入的用户
- 需要在本地环境中用自己的 API 密钥运行服务器的开发者
T
52FMRS · D
该服务器由 Twelve Data 官方维护，围绕其金融数据 API 提供云端（OAuth）和本地（API 密钥）两种接入方式，功能覆盖价格、技术指标、基本面、新闻和监管数据；使用前提是拥有 Twelve Data 账户，且仓库未注明许可证。
Twelve Data MCP 服务器让 Claude、ChatGPT 等 AI 助手通过 Model Context Protocol 访问 Twelve Data 金融 API，提供实时和历史价格、60 多种技术指标、基本面数据、财报、股息、ETF、公司新闻、市场异动等信息。使用前需要注册 Twelve Data 账户。官方提供两种接入方式：托管的云端服务器（通过浏览器 OAuth 登录，无需安装或手动管理 API 密钥）和本地运行方式（需要 Python 3.10+，通过 .env 文件配置自己的 API 密钥，以 stdio 方式与 Claude Desktop 通信）。
工具能力
暂未整理工具清单。
安装接入
方式一（推荐，云端服务器）：在 Claude 或 ChatGPT 的连接器/集成设置中添加 URL https://mcp.twelvedata.com/mcp，连接时会打开浏览器完成 Twelve Data 账户登录和授权，个人 API 密钥自动关联，无需手动配置。方式二（本地运行）：在 Twelve Data 账户仪表盘获取 API 密钥；安装 Python 3.10+（推荐 3.12）后运行 make install；在项目根目录创建 .env 文件并写入 TWELVE_DATA_API_KEY=你的密钥；在 Claude Desktop 配置文件 claude_desktop_config.json 中添加 mcpServers 条目，command 指向项目内 .venv/bin/python，args 指向 src/server.py（务必使用虚拟环境中的 Python，而非系统自带的旧版本）；保存后重启 Claude Desktop。
claude_desktop_config.json
{
"mcpServers": {
"twelvedata": {
"command": "/path/to/twelve-data-mcp/.venv/bin/python",
"args": [
"/path/to/twelve-data-mcp/src/server.py"
]
}
}
}
选型与风险
不适合谁
- 没有 Twelve Data 账户、不愿意注册或授权的用户
- 需要完全离线、不依赖第三方数据源的场景
- 与金融市场数据无关的通用任务
所需权限
- 云端方式：通过浏览器 OAuth 登录并将账户与 Twelve Data 服务关联
- 本地方式：读取 .env 文件中的 TWELVE_DATA_API_KEY 并用其调用 Twelve Data API
- 对外发起网络请求以获取市场数据（云端方式请求发往 mcp.twelvedata.com，本地方式直接请求 Twelve Data API）
风险与副作用
- 云端服务器由 Twelve Data 托管，使用前需要将账户授权给第三方服务
- 本地运行时 API 密钥以明文形式存放在 .env 文件中，需妥善保管避免泄露
- 数据请求量和可用功能受 Twelve Data 账户套餐及速率限制约束
- 仓库未标注开源许可证，使用和二次分发的法律条款不明确
常见排障
- 本地运行报错或无法启动时，确认使用的是项目虚拟环境中的 .venv/bin/python，而非系统自带的 Python（如 macOS 自带的 3.9 版本过低）
- 确认已安装 Python 3.10 及以上版本（推荐 3.12）
- 检查 .env 文件是否存在且包含正确的 TWELVE_DATA_API_KEY
- 修改 claude_desktop_config.json 后需要重启 Claude Desktop 才能生效
- 使用云端连接器时，若登录弹窗未出现或授权失败，检查浏览器弹窗拦截设置及网络连接
使用场景
查询股票、ETF、外汇、加密货币的实时或历史价格
计算 RSI、MACD、SMA、布林带等技术指标
获取公司财报、股息、拆股、财务报表和关键统计数据
查看基金（ETF/共同基金）的业绩、持仓和风险信息
获取公司新闻、市场异动、分析师评级和目标价
查询 SEC/EDGAR 监管文件、内部人交易和机构持仓
支持客户端
Claude Desktop完整支持
ChatGPT完整支持