MCP Server Kalshi

這是一個用於Kalshi REST API的MCP服務器項目，支持通過UVX或Docker進行配置和部署，並提供本地開發和測試指南。

金融開發者工具 #Kalshi接口 #MCP服務 #API對接 .Python

評分 : 2.5分

下載量 : 7.4K

更新時間 : 2025-04-29

打開站點

什麼是 Kalshi MCP 服務器？

Kalshi MCP 服務器提供了一個標準接口，用於通過 Model Context Protocol 與 Kalshi 預測市場平臺交互。它處理身份驗證，並代理到 Kalshi 的交易 API。

如何使用 Kalshi MCP 服務器？

你可以在本地運行該服務器，或者在容器中運行，然後配置你的 MCP 客戶端連接到它。服務器需要你的 Kalshi API 憑證來進行身份驗證。

使用場景

此服務器適用於開發人員構建交易機器人、分析工具或任何需要與 Kalshi 預測市場進行程序化交互的應用。

關鍵功能

認證處理

協議代理

環境適配

如何使用

安裝服務器

配置憑證

設置環境

啟動服務

連接客戶端

使用示例

常見問題解答

如何獲取 Kalshi API 憑證？

能否使用測試賬戶？

UVX 和 Docker 部署有什麼區別？

額外資源

Kalshi API 文檔

官方 Kalshi 交易 API 參考文檔。

Model Context Protocol

MCP 規範和工具倉庫。

創建測試賬戶

設置 Kalshi 測試賬戶的指南。

🚀 MCP 服務器 Kalshi

這是一個用於 Kalshi REST API 的 MCP 服務器，可幫助用戶與 Kalshi 的 API 進行交互，實現相關業務功能。

🚀 快速開始

配置

Claud Desktop

✨ 使用 UVX 進行設置

"mcpServers": {
  "kalshi": {
    "command": "uvx",
    "args": ["mcp-server-kalshi"],
    "env": {
        "KALSHI_PRIVATE_KEY_PATH": "你的 RSA 密鑰文件路徑",
        "KALSHI_API_KEY": "<你的 Kalshi API 密鑰>",
        "BASE_URL": "https://api.elections.kalshi.com"
    }
  }
}

✨ 使用 Docker 進行設置

docker build -t mcp-server-kalshi .

配置客戶端以運行容器（確保 bind 命令允許容器訪問你的 rsa 密鑰文件）：

"mcpServers": {
  "kalshi": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "-e", "KALSHI_PRIVATE_KEY_PATH", "-e", "KALSHI_API_KEY","-e", "BASE_URL", "mcp-server-kalshi"],
    "env": {
        "KALSHI_PRIVATE_KEY_PATH": "你的 RSA 密鑰文件路徑",
        "KALSHI_API_KEY": "<你的 Kalshi API 密鑰>",
        "BASE_URL": "https://api.elections.kalshi.com"
    }
  }
}

本地開發

在根目錄下創建一個 .env 文件，包含以下變量：
- BASE_URL：Kalshi API 的 URL 地址
- KALSHI_API_KEY：對應環境的 Kalshi API 密鑰
- KALSHI_PRIVATE_KEY_PATH：包含你的 Kalshi RSA 私密鑰文件的路徑
安裝依賴項：
- 普通依賴項：

uv pip install -e .

開發依賴項：

uv pip install -e .[dev]

啟動服務器：

uv run start

獲取 Kalshi API 憑證

要獲取 Kalshi API 憑證，請按照此處的說明進行操作。

獲取測試賬戶

你可能希望將服務器與一個 Kalshi 測試賬戶一起使用。要獲得一個測試賬戶，請按照此處的說明進行操作。

然後，設置 BASE_URL=https://demo-api.kalshi.co 用於此 MCP 服務器，並更新你的 KALSHI_API_KEY 和 KALSHI_PRIVATE_KEY_PATH 指向測試環境生成的憑證。

UVX

在 MCP 監視器中運行

npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-server-kalshi run start

在 Claud Desktop 中運行

更新你的 MCP 配置為：

{
    "mcpServers": {
        "kalshi": {
            "command": "uv",
            "args": [ 
            "--directory",
            "/<path to repo root directory>",
            "run",
            "start"
            ],
            "env": {
                "KALSHI_PRIVATE_KEY_PATH": "你的 RSA 密鑰文件路徑",
                "KALSHI_API_KEY": "<你的 Kalshi API 密鑰>",
                "BASE_URL": "https://api.elections.kalshi.com"
            }
        }
    }
}