使用说明
Kalshi MCP服务器
基于FastMCP的服务器使Claude和其他LLM能够通过自然语言与Kalshi预测市场进行交互。
这是什么
一种模型上下文协议(MCP)服务器,为LLM代理提供以下工具:
- 研究预测市场
- 执行交易(市价单和限价单)
- 管理投资组合和头寸
- 监控帐户活动
内置 FastMCP 与Claude Code、Claude Desktop和其他MCP客户端无缝集成。
当前状态
看 docs/kalshi-mcp-prd.md 了解完整的状态、路线图和实施细节。
主要特点
- 🔐 安全认证 -基于RSA-PSA签名的API认证
- 🌍 双重环境 -独立的演示(测试资金)和生产(真实资金)服务器
- 🛡️ 安全限值 -内置验证和可配置的订单大小限制
- 📊 丰富的数据模型 -具有LLM友好解释的类型安全Pydantic模型
- ✅ 综合测试 -60+VCR盒式重放集成测试
快速开始
安装说明: 看 设置.md
使用示例:
User: "@kalshi_demo search for bitcoin markets"
User: "@kalshi_demo check my balance"
User: "@kalshi_demo buy 10 YES contracts on KXBTC-31DEC-50K at 45¢"
文档
- 设置.md -完整的设置指南
- CLAUDE.md -开发模式和技术参考
- docs/kalshi-mcp-prd.md -产品要求、状态和路线图
- docs/集成测试.md -测试基础设施
项目结构
src/kalshi/
├── kalshi_mcp_server.py # FastMCP server with 16 tools
├── client.py # Kalshi API client
└── models.py # Pydantic models
run_kalshi_mcp_demo.py # Demo wrapper (test money)
run_kalshi_mcp_prod.py # Production wrapper (real money)
tests/ # 60+ integration tests
需求
安全
所有凭据都是合法的:
.env.kalshi.demo/.env.kalshi.prodsecrets/带私钥的目录
看 设置.md 用于安全的凭证管理。
许可证
请参阅许可证文件。