MCP

🚀 十二数据MCP服务器

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

⚠️ 重要提示

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

🚀 快速开始

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

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

⚠️ 重要提示

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

✨ 主要特性

十二数据MCP服务器提供了以下实用工具：

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 Desktop集成

将以下代码片段添加到你的 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 Desktop连接到十二数据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 Desktop：更新 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许可证。详情请参阅 LICENSE 文件。