MCP

🚀 十二数据MCP服务器

十二数据MCP服务器可与十二数据API实现无缝集成，让你能够访问金融市场数据。它支持获取股票、外汇对和加密货币的历史时间序列、实时报价以及工具元数据。

⚠️ 重要提示

此服务器目前处于早期开发阶段，其功能和工具可能会随着十二数据API的更新而演变。

🚀 快速开始

若要使用十二数据MCP服务器，你首先需要从十二数据获取API密钥：

1. 访问 十二数据注册页面。
2. 创建一个账户，若已有账户则直接登录。
3. 进入你的仪表盘并复制API密钥。

⚠️ 重要提示

根据你的十二数据订阅计划，对特定端点或市场的访问权限可能会有所不同。

✨ 主要特性

本服务器提供了以下工具来满足不同的需求：

1. time_series：获取某个符号的历史价格数据。
   • 输入参数：
     • symbol（字符串）：股票代码，例如 AAPL。
     • interval（字符串）：数据间隔，例如 1min、1day。
     • start_date（字符串，可选）：ISO - 8601格式的开始时间戳。
     • end_date（字符串，可选）：ISO - 8601格式的结束时间戳。
   • 返回值：OHLCV（开盘价、最高价、最低价、收盘价、成交量）数据条目的数组。
2. price：获取某个符号的最新价格。
   • 输入参数：
     • symbol（字符串）
   • 返回值：最新的价格报价。
3. stocks：列出可用的股票工具。
   • 输入参数：
     • exchange（字符串，可选）：用于过滤的交易所代码。
   • 返回值：股票元数据的数组。
4. forex_pairs：列出可用的外汇对。
   • 输入参数：无
   • 返回值：外汇对元数据的数组。
5. cryptocurrencies：列出可用的加密货币。
   • 输入参数：无
   • 返回值：加密货币元数据的数组。

📦 安装指南

使用 UV（推荐）

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

uvx mcp-server-twelve-data --help

使用 pip

通过pip安装服务器：

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

📚 详细文档

配置

Claude桌面集成

将以下代码片段添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["--reinstall", "mcp-server-twelve-data", "--apikey", "YOUR_API_KEY"]
    }
  }
}

或者，若要使用我们的远程HTTP服务器，请使用以下配置：

{
  "mcpServers": {
    "twelvedata-remote": {
      "command": "npx",
      "args":    [
        "mcp-remote", "https://mcp.twelvedata.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "apikey YOUR_API_KEY"
      }
    }
  }
}

看看将Claude桌面与十二数据MCP服务器连接是多么简单：

VS Code集成

自动设置（使用UV）

点击 进行安装。

手动设置

若要手动配置，请将以下内容添加到你的 用户设置（JSON） 中：

{
  "mcp": {
    "servers": {
      "twelvedata": {
        "command": "uvx",
        "args": ["mcp-server-twelve-data", "-t", "streamable-http"]
      }
    }
  }
}

调试

使用MCP检查器进行故障排除：

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data

开发指南

1. 本地测试：按照 调试 部分的描述使用MCP检查器。
2. Claude桌面：更新 claude_desktop_config.json 以引用本地源代码路径。

Docker使用

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

docker build -t mcp-server-twelve-data .
docker run --rm mcp-server-twelve-data --apikey YOUR_API_KEY

📄 许可证

此MCP服务器采用MIT许可证。有关详细信息，请参阅 许可证文件。