金大哥 - mcp-server-kalshi MCP 详情

article

README

🚀 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"
            }
        }
    }
}

{ "rating": 2.5, "dev_lang": "python", "mcp_install": "\"mcpServers\": {\n \"kalshi\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-kalshi\"],\n \"env\": {\n \"KALSHI_PRIVATE_KEY_PATH\": \"PATH TO YOUR RSA KEY FILE\",\n \"KALSHI_API_KEY\": \"<YOUR KALSHI API KEY>\",\n \"BASE_URL\": \"https://api.elections.kalshi.com\"\n }\n }\n}\n\n\"mcpServers\": {\n \"kalshi\": {\n \"command\": \"docker\",\n \"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\"],\n \"env\": {\n \"KALSHI_PRIVATE_KEY_PATH\": \"PATH TO YOUR RSA KEY FILE\",\n \"KALSHI_API_KEY\": \"<YOUR KALSHI API KEY>\",\n \"BASE_URL\": \"https://api.elections.kalshi.com\"\n }\n }\n}\n\n{\n \"mcpServers\": {\n \"kalshi\": {\n \"command\": \"uv\",\n \"args\": [ \n \"--directory\",\n \"/<path to repo root directory>\",\n \"run\",\n \"start\"\n ],\n \"env\": {\n \"KALSHI_PRIVATE_KEY_PATH\": \"PATH TO YOUR RSA KEY FILE\",\n \"KALSHI_API_KEY\": \"<YOUR KALSHI API KEY>\",\n \"BASE_URL\": \"https://api.elections.kalshi.com\"\n }\n }\n }\n}" }

mcp-server-kalshi