MCP Server Kalshi

这是一个用于Kalshi REST API的MCP服务器项目，支持通过UVX或Docker进行配置和部署，并提供本地开发和测试指南。

金融开发者工具 #Kalshi接口 #MCP服务 #API对接 .Python

评分 : 2.5分

下载量 : 9.5K

更新时间 : 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"
            }
        }
    }
}