Twelve Data MCP Server

官方

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

GitHub
70

文档

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，然后通过浏览器弹窗登录。

选项 2 — 使用你的 API 密钥在本地运行

更倾向于在自己的机器上运行服务器（例如，通过 stdio 为 Claude Desktop 运行）？你只需要你的 Twelve Data API 密钥——无需 OAuth 设置。

1. 获取你的 API 密钥

登录 twelvedata.com → 你的仪表板 → API 密钥。复制你的密钥。

2. 安装

需要 Python 3.10+（推荐 3.12；在 macOS 上使用 brew install [email protected] 或 make python-install）。

make install

3. 添加你的 API 密钥

在项目根目录创建一个 .env 文件，并填入你的密钥：

TWELVE_DATA_API_KEY=your_api_key_here

4. 连接到 Claude Desktop

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

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

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

就这样——服务器会从 .env 读取你的 API 密钥，每个请求都会使用它。无需登录步骤。

你可以询问的内容

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

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

合作伙伴

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