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 文件。