🚀 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",
"/" ,
"run",
"start"
],
"env": {
"KALSHI_PRIVATE_KEY_PATH": "你的 RSA 密钥文件路径",
"KALSHI_API_KEY": "<你的 Kalshi API 密钥>",
"BASE_URL": "https://api.elections.kalshi.com"
}
}
}
}