【技术文档摘要】

Twelve Data MCP Server

概述

Twelve Data MCP Server 提供了与 Twelve Data API 的无缝集成，以访问金融市场数据。它支持获取股票、外汇对和加密货币的历史时间序列、实时报价和工具元数据。

注意：此服务器目前处于早期开发阶段；功能和工具可能会随着 Twelve Data API 的更新而演变。

获取您的 API 密钥

要使用 Twelve Data MCP Server，您必须首先从 Twelve Data 获取一个 API 密钥：

1. 访问 Twelve Data 注册页面。
2. 创建一个账户或登录您的现有账户。
3. 转到您的仪表板并复制您的 API 密钥。

重要提示：根据您的 Twelve Data 订阅计划，特定端点或市场的访问权限可能有所不同。

U-tool

u-tool 是一个由人工智能驱动的通用路由器，用于 Twelve Data API，它改变了您访问金融数据的方式。无需导航 100 多个单独的端点和复杂的文档，只需用简单的英语描述您需要的内容即可。

工作原理： 🧠 自然语言处理：理解您用对话式英语提出的请求 🔍 智能路由：使用向量搜索从 Twelve Data 整个 API 目录中找到最相关的端点 🎯 智能选择：利用 OpenAI GPT-4o 选择最佳方法并生成正确的参数 ⚡ 自动执行：调用适当的端点并返回格式化的结果

您可以询问的内容： 📈 “显示本周苹果股票的表现” 📊 “计算比特币 14 天周期的 RSI” 💰 “获取特斯拉的财务比率和资产负债表” 🌍 “比较过去 6 个月的欧元兑美元汇率” 🏦 “查找表现最好的科技 ETF”

支持的数据类别：

• 市场数据及报价 • 技术指标（100+）
• 基本面数据及财务信息 • 货币及加密货币
• 共同基金及 ETF • 经济日历及事件

一种工具，整个 Twelve Data 生态系统。无需 API 文档。

安装

使用 UV（推荐）

无需本地安装直接运行使用 uvx：

uvx mcp-server-twelve-data --help

使用 pip

通过 pip 安装服务器：

pip install mcp-server-twelve-data
python -m mcp_server_twelve_data --help

配置

Claude Desktop 集成

在您的 claude_desktop_config.json 中添加以下片段之一： (1) 使用 utool 配置的本地标准 I/O 服务器

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-u", "YOUR_OPEN_AI_APIKEY"]
    }
  }
}

(2) 只有 10 个最受欢迎端点的本地标准 I/O 服务器

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["m_erver-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-n", "10"]
    }
  }
}

(3) Twelve Data 远程 MCP 服务器

{
  "mcpServers": {
    "twelvedata-remote": {
      "command": "npx",
      "args":    [
        "mcp-remote", "https://mcp.twelvedata.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}",
        "--header",
        "X-OpenAPI-Key:${OPENAI_API_KEY}"
      ],
      "env": {
        "AUTH_HEADER": "apikey YOUR_TWELVE_DATA_API_KEY",
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

看看如何轻松地将 Claude Desktop 连接到 Twelve Data MCP Server：

VS Code 集成

自动设置（使用 UV）

手动设置

对于手动配置，请在您的 用户设置（JSON） 中添加：

{
  "mcp": {
    "servers": {
      "twelvedata": {
          "command": "uvx",
          "args": [
            "mcp-server-twelve-data",
            "-k", "YOUR_TWELVE_DATA_API_KEY",
            "-u", "YOUR_OPENAI_API_KEY"
          ]
        }
    }
  }
}

调试

使用 MCP Inspector 进行故障排除：

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data@latest -k YOUR_TWELVE_DATA_API_KEY

开发指南

1. 本地测试：按照 调试 部分所述使用 MCP Inspector。
2. Claude Desktop：更新 claude_desktop_config.json 以引用本地源路径。

Docker 使用

使用 Docker 构建并运行服务器：

docker build -t mcp-server-twelve-data .

docker run --rm mcp-server-twelve-data \
  -k YOUR_TWELVE_DATA_API_KEY \
  -u YOUR_OPENAI_API_KEY \
  -t streamable-http

许可证

此 MCP 服务器采用 MIT 许可证。详情请参见 LICENSE 文件。