Twelve Data

官方

与Twelve Data API交互，为您的AI代理获取实时和历史金融市场数据。

GitHub

你可以用 Twelve Data MCP 做什么？

实时与历史价格 — 查询股票、ETF、外汇、加密货币或大宗商品（如 AAPL 或 BTC/USD）的当前或历史报价。
技术指标 — 请求任何受支持代码的 RSI、MACD、SMA、BBANDS、ATR 或其他 60 多种指标。
基本面与企业行动 — 获取盈利、股息、拆股、财务报表、公司简介、市值或关键统计数据。
市场新闻与情报 — 获取公司新闻、新闻稿、市场异动、分析师评级、目标价或汇率。
基金与监管数据 — 访问 ETF/共同基金简介、持仓、SEC/EDGAR 申报文件、内部交易或机构持仓。

文档

Twelve Data MCP 服务器

将 Claude、ChatGPT 及其他 AI 助手连接到 Twelve Data 金融 API —— 实时和历史价格、60 多种技术指标、基本面数据、财报、股息、ETF、公司新闻、市场异动等。

您需要一个 Twelve Data 账户。请在 twelvedata.com 注册。

有两种使用方式。大多数人应使用云服务器（方式一） —— 无需安装任何内容。

方式一 —— 使用我们的云服务器（推荐）

将您的 AI 助手连接到我们的托管服务器：

https://mcp.twelvedata.com/mcp

就这样。无需安装，无需复制粘贴 API 密钥。连接时，浏览器窗口会打开，您使用 Twelve Data 账户登录 —— 您的个人 API 密钥会自动关联并始终绑定到您的账户。

如何添加

Claude（桌面版 / 网页版）和 ChatGPT 支持自定义连接器 / MCP 服务器：

打开您助手的 连接器（或集成 / MCP 服务器）设置。
使用 URL https://mcp.twelvedata.com/mcp 添加新连接器。
出现提示时，点击 连接 / 登录 —— 浏览器中会打开 Twelve Data 登录页面。
授权后即完成。您可以询问类似 “AAPL 的 RSI 是多少？” 或 “显示 TSLA 最新的财报。”

不同应用和版本中的菜单名称可能不同，但流程始终相同：添加 URL，然后通过浏览器弹窗登录。

MCP 主机不签发令牌。连接器 URL 为 https://mcp.twelvedata.com/mcp。客户端必须按照该 URL 的受保护资源元数据，前往其中指定的授权服务器。请勿将连接器指向主机根路径（会返回 404），也不要指向此主机的 /register 或 /.well-known/oauth-authorization-server。

Perplexity（自定义远程连接器）

Perplexity Pro、Max 和 Enterprise 用户可以将托管服务器添加为自定义远程连接器。这是按账户进行的设置，并非 Perplexity 公开精选目录中的条目。

在 Perplexity 中，打开 账户设置 → 连接器 → + 自定义连接器，选择远程。在 Enterprise 版本中，管理员可能需要先允许自定义连接器。
将名称设置为 Twelve Data，MCP 服务器 URL 设置为 https://mcp.twelvedata.com/mcp。
选择 OAuth 作为认证方式，Streamable HTTP 作为传输方式。将客户端 ID 和客户端密钥留空，以便 Perplexity 在服务器受保护资源元数据中指定的授权服务器上使用动态客户端注册。
接受 Perplexity 的自定义连接器确认并点击添加。然后点击 Twelve Data 连接器卡片开始认证，登录您的 Twelve Data 账户并授权访问。
连接器启用后，尝试以下提示：
- “使用 Twelve Data 查找 AAPL 的代码。”
- “使用 Twelve Data 获取 AAPL 的最新报价，包括价格和成交量。”
- “使用 Twelve Data 显示 AAPL 最近五个交易日的收盘价。”
- “使用 Twelve Data 显示 AAPL 的 RSI。”

每个人使用自己的 Twelve Data 账户登录。如果 Enterprise 管理员共享连接器，请要求每位成员单独认证。请勿将 Twelve Data API 密钥粘贴到连接器的 API 密钥认证字段中。

如果 OAuth 窗口被拦截、登录失败或工具在空闲后停止响应，请打开 Twelve Data 连接器，先禁用再启用，然后重新登录。请通过这种方式重新连接，而不要将连接器切换为 API 密钥认证。确认 URL 精确为 https://mcp.twelvedata.com/mcp，末尾无斜杠，并且您的 Twelve Data 套餐包含所请求的数据。有关当前设置界面的信息，请参阅 Perplexity 的自定义远程连接器指南。

Codex（CLI、桌面版和 IDE）

将托管 MCP 服务器添加到 Codex，无需安装此仓库或复制 API 密钥：

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add 命令会启动 OAuth：在浏览器中完成 Twelve Data 登录。如果之后需要重新授权，请运行 codex mcp login twelvedata。在 Codex 中，使用 /mcp 检查连接，然后询问：“使用 Twelve Data 获取 AAPL 的最新报价。” 和 “使用 Twelve Data 显示 AAPL 的 RSI。” 要断开连接，请运行 codex mcp remove twelvedata。

公共插件仓库为 https://github.com/MazeBraker/twelvedata-skills. 它会安装技能和相同的托管 MCP：

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

方式二 —— 使用 API 密钥自行运行

更喜欢在您自己的机器上运行服务器？您只需要 Twelve Data API 密钥 —— 无需 OAuth 设置。请在 twelvedata.com → 您的仪表板 → API 密钥 获取。

1. 安装

需要 Python 3.10+（推荐 3.12；在 macOS 上为 brew install python@3.12 或 make python-install）。

make install

2. 添加您的 API 密钥

在项目根目录创建 .env 文件，写入您的密钥，并确保仅您本人可读：

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

服务器从 .env 读取密钥，每个请求都会使用它。无需登录步骤。

3. 通过 stdio 连接

Claude Desktop —— 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

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

请使用 .venv/bin/python 路径（不要使用系统 Python —— macOS 自带 3.9，而此服务器需要 3.10+）。编辑配置后重启 Claude Desktop。

Claude Code：

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

4. 通过 HTTP 连接

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. 在 Docker 中运行

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file 可将密钥排除在 shell 历史记录之外。按照第 4 步连接到 http://localhost:8000/mcp。Docker 中不支持 OAuth 登录。

6. 安全性

make run 和 Docker 在 0.0.0.0 上默认提供 无认证 的 /mcp 服务。
每次调用都使用您的凭据。
任何能访问该端口的人都可以调用 auth_status 和 oauth_configure。这包括您打开的网页，通过 DNS 重绑定即可实现，因为默认绑定既不检查 Host 也不检查 Origin 头。
MCP_HOST=127.0.0.1 make run 可将服务器保持在本机，并启用 MCP SDK 的 Host 和 Origin 检查。
使用 MCP_HOST=127.0.0.1 时，ngrok 仅在以 --host-header=rewrite 启动时才能正常工作。

7. 故障排查

首先从您的客户端调用 auth_status。它会显示是否配置了 API 密钥、存储的令牌、检测到的主机和重定向 URI —— 通常足以看出缺少了什么。

您可以询问的内容

价格 —— 股票、ETF、外汇、加密货币、大宗商品（实时和历史）
技术指标 —— RSI、MACD、SMA、BBANDS、ATR 及 60 多种其他指标
基本面数据 —— 财务报表、财报、股息、拆股、公司简介、市值、关键统计、IPO 日历
基金 —— ETF 和共同基金简介、业绩、持仓、风险
新闻 —— 公司新闻和新闻稿
市场情报 —— 异动股、汇率、分析师评级、目标价
监管 —— SEC/EDGAR 申报文件、内部人交易、机构持仓

代码格式：股票 AAPL、加密货币 BTC/USD、外汇 EUR/USD。

合作伙伴

正在运行您自己的公共实例或设置专用的 OAuth 登录？这属于合作伙伴安排 —— 请通过 twelvedata.com 联系我们，我们将提供设置指南和 OAuth 凭据。