MCP Server Kalshi

这是一个用于Kalshi REST API的MCP服务器。

配置

Claud Desktop

<details> <summary>使用UVX进行配置</summary>

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

</details> <details> <summary>使用Docker进行配置</summary>

1. 从根目录构建容器 docker build -t mcp-server-kalshi .

2. 配置客户端以运行容器（确保绑定命令允许容器访问你的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"
    }
  }
}

</details>

本地开发

1. 在根目录创建一个.env文件，并包含以下变量

   • BASE_URL Kalshi API的URL
   • KALSHI_API_KEY 对应环境的API密钥
   • KALSHI_PRIVATE_KEY_PATH 包含你的Kalshi RSA私钥文件的路径

2. 使用uv pip install -e .安装依赖。开发依赖可以通过uv pip install -e .[dev]来安装。

3. 使用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 Inspector中运行

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

要在Claud Desktop中运行，更新你的MCP配置为：

{
    "mcpServers": {
        "kalshi": {
            "command": "uv",
            "args": [ 
            "--directory",
            "/<repo根目录路径>",
            "run",
            "start"
            ],
            "env": {
                "KALSHI_PRIVATE_KEY_PATH": "你的RSA密钥文件路径",
                "KALSHI_API_KEY": "<你的Kalshi API密钥>",
                "BASE_URL": "https://api.elections.kalshi.com"
            }
        }
    }
}