Twelve Data

Twelve Data MCP 服务

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

你需要拥有 Twelve Data 账户。请前往 twelvedata.com 注册。

有两种使用方式。大多数人应该使用云端服务（选项 1）——无需安装任何内容。

---

选项 1 — 使用我们的云端服务（推荐）

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

https://mcp.twelvedata.com/mcp

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

添加方法

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

1. 打开助手的连接器（或集成 / MCP 服务）设置。
2. 添加新连接器，URL 填写为 https://mcp.twelvedata.com/mcp。
3. 出现提示时，点击连接 / 登录——浏览器会打开 Twelve Data 登录页面。
4. 授权即可完成。你可以询问“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 公共精选目录中的条目。

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

每个人都应使用自己的 Twelve Data 账户登录。如果 Enterprise 管理员共享了连接器，请要求每位成员单独进行身份验证。不要将 Twelve Data API 密钥粘贴到连接器的 API Key 身份验证栏中。

如果 OAuth 窗口被拦截、登录失败或工具在闲置一段时间后停止工作，请打开 Twelve Data 连接器，将其禁用后再重新启用，然后登录。请通过这种方式重新连接，不要将连接器改为 API Key 身份验证。确认 URL 准确为 https://mcp.twelvedata.com/mcp，末尾没有斜杠，并确认 Twelve Data 套餐包含所请求的数据。当前设置界面请参阅 Perplexity 自定义远程连接器指南。

Codex（CLI、桌面应用和 IDE）

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

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

---

选项 2 — 使用 API 密钥自行运行

更倾向于在自己的计算机上运行服务？你只需要 Twelve Data API 密钥，无需设置 OAuth。前往 twelvedata.com → 控制面板 → API Keys 获取密钥。

1. 安装

需要 Python 3.10+（推荐使用 3.12；在 macOS 上运行 brew install [email protected] 或 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。由于默认绑定不会检查 Host 或 Origin 标头，因此你打开的网页也可能通过 DNS 重绑定进行访问。
• 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 凭据。