Twelve Data MCP Server

官方

将 AI 助手连接到 Twelve Data 金融市场数据

分类: 其他第 131 / 230
Stars: ★ 82 热门
传输方式: Streamable HTTP · stdio（本地进程）
运行环境: Python 3.10+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
最近提交: 10 天前

52FMRS · D

该服务器由 Twelve Data 官方维护，围绕其金融数据 API 提供云端（OAuth）和本地（API 密钥）两种接入方式，功能覆盖价格、技术指标、基本面、新闻和监管数据；使用前提是拥有 Twelve Data 账户，且仓库未注明许可证。

最强项 · 安装易用性 13/20 最弱项 · 维护活跃度 7/20

可靠性

8/20

安全与权限

13/20

维护活跃度

7/20

文档质量

11/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README 描述了两条路径(云端 OAuth 与本地 stdio),本地路径给出了具体入口文件 src/server.py 与配置示例,流程表面自洽,但仓库中未提供可核验的 CI workflow、测试用例或工具清单(manifest 未缓存),无法确认 MCP 初始化/工具列表握手、声明工具与实际行为是否一致,也没有错误处理或依赖可控性的说明。按静态评审规则,无法核验执行证据时可靠性不得超过 12 分,给予 8 分体现'happy path 看似可行但测试与异常处理证据缺失'。
安全与权限 13/20: 该服务本质是只读金融数据查询,不涉及删除、支付、远程执行等不可逆高危操作,风险敞口相对较小。云端方案通过浏览器 OAuth 登录并将 API key 与账户绑定,避免了在客户端配置中硬编码密钥;本地方案使用 .env 文件存放 API key,是较常见的做法,文档未见示例中出现真实密钥。但文档未说明 OAuth 令牌的存储、生命周期与撤销机制,未披露云端服务器对请求/响应数据的处理与留存策略,也没有关于最小权限范围或第三方数据流向的详细说明,'Partners' 部分提到的自建 OAuth 凭证发放流程也缺乏细节。综合评定为主要风险可见但权限范围与数据流披露不完整,给 13 分。
维护活跃度 7/20: 许可证状态为'unknown',这是明确的扣分项,可能影响使用者的合规判断。仓库有 74 星、4 个未关闭 issue 且未被归档,提示项目仍在维护,但源材料中未提供提交历史、发布节奏、依赖更新记录或安全响应渠道等可验证证据,无法评估治理规范性与版本管理水平。综合给 7 分,体现'有一定活跃迹象但许可证缺失+治理证据不足'。
文档质量 11/20: README 结构清晰,包含云端与本地两种安装方式、认证流程、按类别列出的可用数据能力(价格、技术指标、基本面、新闻等)以及符号格式示例,对新手较友好。但缺少具体工具/参数级别的文档(如每个 MCP 工具的输入输出 schema)、速率限制与费用说明、故障排查章节,以及关于云端服务数据留存的说明,一些假设(如非 macOS 平台的本地部署细节)未被充分展开。给 11 分,即'可用但存在隐藏假设与故障排查空白'。
安装易用性 13/20: 云端方案仅需填入一个 URL 并完成浏览器登录,门槛很低;本地方案给出了 Python 版本要求、make install、.env 配置与 Claude Desktop JSON 配置示例,步骤清晰具体。但本地配置需要手动编辑 JSON 并填写绝对路径,容易出错;文档主要面向 macOS(提及 brew 安装 Python),未明确 Windows/Linux 的兼容性与常见故障处理;且没有仓库层面的 CI 或自动化测试来验证安装流程的可重复性。按静态评审规则,无可执行证据时安装易用性不得超过 15 分,给予 13 分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

已拥有 Twelve Data 账户、需要在 AI 助手中查询金融市场数据的个人或团队
希望免安装、通过云端连接器快速接入的用户
需要在本地环境中用自己的 API 密钥运行服务器的开发者

不适合谁

没有 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 账户套餐及速率限制约束
仓库未标注开源许可证，使用和二次分发的法律条款不明确

安装接入

准备工作

运行环境：Python 3.10+ · 远程托管（无需本地环境）

TWELVE_DATA_API_KEY 必填密钥 Twelve Data 平台的 API 密钥，登录 twelvedata.com 后在控制台的 API Keys 页面获取。

方式一（推荐，云端服务器）：在 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": [
        "/path/to/twelve-data-mcp/src/server.py"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add twelvedata -- /path/to/twelve-data-mcp/.venv/bin/python /path/to/twelve-data-mcp/src/server.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 中连接后，询问“What's the RSI for AAPL?”，如果返回有效的技术指标数值，说明服务器已正确连接。

常见排障

本地运行报错或无法启动时，确认使用的是项目虚拟环境中的 .venv/bin/python，而非系统自带的 Python（如 macOS 自带的 3.9 版本过低）
确认已安装 Python 3.10 及以上版本（推荐 3.12）
检查 .env 文件是否存在且包含正确的 TWELVE_DATA_API_KEY
修改 claude_desktop_config.json 后需要重启 Claude Desktop 才能生效
使用云端连接器时，若登录弹窗未出现或授权失败，检查浏览器弹窗拦截设置及网络连接

试试这样问

连接成功后，可以直接对 AI 助手这样说：

AAPL 的 RSI 是多少？
显示 TSLA 最新的财报。
查一下 BTC/USD 的实时价格。
给我 EUR/USD 的历史汇率数据。

使用场景

查询股票、ETF、外汇、加密货币的实时或历史价格

计算 RSI、MACD、SMA、布林带等技术指标

获取公司财报、股息、拆股、财务报表和关键统计数据

查看基金（ETF/共同基金）的业绩、持仓和风险信息

获取公司新闻、市场异动、分析师评级和目标价

查询 SEC/EDGAR 监管文件、内部人交易和机构持仓

支持客户端

Claude Desktop

ChatGPT

依据项目文档列出，未经本站实测。

详细介绍

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 通信）。