预测市场交互服务器

一个基于FastMCP的服务器,使Claude和其他大型语言模型能够通过自然语言与Kalshi预测市场进行交互,包括研究市场、执行交易、管理投资组合和监控账户活动。

  • by TweedBeetle
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 TweedBeetle/kalshi-mcp-server

使用说明

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

文档

项目结构

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

需求

  • Python 3.11+
  • uv 包管理器
  • 具有API访问权限的Kalshi帐户(演示 或 生产)

安全

所有凭据都是合法的:

  • .env.kalshi.demo / .env.kalshi.prod
  • secrets/ 带私钥的目录

看 设置.md 用于安全的凭证管理。

许可证

请参阅许可证文件。