Manifold Markets MCP 服务器

一个用于与 Manifold Markets 预测市场交互的 MCP 服务器。该服务器通过一个清晰的 MCP 接口提供对 Manifold 各种功能的全面访问，从而实现复杂的市场交互和集体智慧机制。

架构

该服务器通过一个结构化的工具系统实现了 Manifold Markets API 功能的完整映射：

核心组件

• Schema 层: 基于 Zod 的所有操作的验证模式
• API 集成: 直接映射到 Manifold 的 REST 端点
• 工具处理程序: 使用适当的错误管理进行请求处理
• 类型安全: 完整的 TypeScript 实现

工具类别

市场创建与管理

• create_market: 创建市场 (BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, POLL)
• unresolve_market: 撤销已解决的市场
• close_market: 关闭市场进行交易
• add_answer: 向多项选择市场添加选项

市场互动

• follow_market: 跟踪感兴趣的市场
• react: 喜欢/不喜欢市场和评论
• add_bounty: 为分析添加赏金
• award_bounty: 奖励有价值的贡献

交易操作

• place_bet: 执行市场交易
• cancel_bet: 取消限价单
• sell_shares: 清算头寸

流动性管理

• add_liquidity: 提供市场流动性
• remove_liquidity: 提取提供的流动性

信息检索

• search_markets: 使用过滤器查找市场
• get_market: 详细的市场信息
• get_user: 用户个人资料数据
• get_positions: 投资组合跟踪

社交功能

• send_mana: 在用户之间转移 mana

已验证的功能

该服务器已经通过全面的交互轨迹进行了测试：

成功测试

1. 市场发现与关注

   • ✅ 使用过滤器进行市场搜索
   • ✅ 市场关注
   • ✅ 详细的市场信息检索

2. 交易操作

   • ✅ 流动性提供
   • ✅ 带有概率更新的下注
   • ✅ 头寸清算
   • ✅ 股份出售

3. 权限管理

   • ✅ 基于角色的访问控制
   • ✅ 身份验证处理
   • ✅ 错误消息

权限限制操作

这些操作已实现，但需要特定的用户角色：

• 市场解决/撤销解决（市场创建者）
• 市场关闭（市场创建者）
• 赏金管理（市场创建者）
• 流动性移除（流动性提供者）

前提条件

• Node.js 18 或更高版本
• npm 或 yarn
• Manifold Markets API 密钥
• 至少 M$1000 的余额用于市场创建

安装

1. 安装包

npm install manifold-mcp-server

2. 获取您的 API 密钥

1. 登录到 Manifold Markets
2. 转到您的个人资料设置
3. 生成一个 API 密钥
4. 确保帐户有足够的 mana 用于预期的操作

3. 配置 MCP 设置

对于 Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

对于 Cline (VSCode Extension)

添加到 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

工具文档

市场创建与管理

create_market

创建一个新的预测市场：

{
  outcomeType: 'BINARY' | 'MULTIPLE_CHOICE' | 'PSEUDO_NUMERIC' | 'POLL' | 'BOUNTIED_QUESTION'
  question: string
  description?: string | {
    type: 'doc'
    content: any[]
  }
  closeTime?: number // Unix 时间戳 ms
  visibility?: 'public' | 'unlisted'
  initialProb?: number // BINARY 必需 (1-99)
  min?: number // PSEUDO_NUMERIC 必需
  max?: number // PSEUDO_NUMERIC 必需
  isLogScale?: boolean
  initialValue?: number // PSEUDO_NUMERIC 必需
  answers?: string[] // MULTIPLE_CHOICE/POLL 必需
  addAnswersMode?: 'DISABLED' | 'ONLY_CREATOR' | 'ANYONE'
  shouldAnswersSumToOne?: boolean
  totalBounty?: number // BOUNTIED_QUESTION 必需
}

unresolve_market

撤销先前已解决的市场：

{
  contractId: string
  answerId?: string // 对于多项选择市场
}

close_market

关闭市场进行交易：

{
  contractId: string
  closeTime?: number // 可选的关闭时间
}

市场互动

follow_market

关注或取消关注市场：

{
  contractId: string
  follow: boolean
}

react

对市场或评论做出反应：

{
  contentId: string
  contentType: 'comment' | 'contract'
  remove?: boolean
  reactionType: 'like' | 'dislike'
}

交易操作

place_bet

在市场上进行下注：

{
  marketId: string
  amount: number
  outcome: 'YES' | 'NO'
  limitProb?: number // 0.01-0.99
}

sell_shares

出售市场中的股份：

{
  marketId: string
  outcome?: 'YES' | 'NO'
  shares?: number // 默认为全部
}

流动性管理

add_liquidity

向市场池添加流动性：

{
  marketId: string
  amount: number
}

remove_liquidity

从市场池中移除流动性：

{
  contractId: string
  amount: number
}

错误处理

该服务器实现了全面的错误处理：

1. 输入验证

   • 通过 Zod 模式进行参数类型检查
   • 值范围验证
   • 必需字段验证

2. API 通信

   • 身份验证错误
   • 网络故障
   • 速率限制
   • 权限检查

3. 业务逻辑

   • 余额不足
   • 无效的市场状态
   • 未经授权的操作

4. 错误响应格式

{
  code: ErrorCode
  message: string
  details?: any
}

开发

# 克隆存储库
git clone https://github.com/bmorphism/manifold-mcp-server.git
cd manifold-mcp-server

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

贡献

欢迎贡献！感兴趣的领域：

• 高级市场分析工具
• 投资组合优化功能
• 与其他预测平台的集成
• 文档改进

安全

• API 密钥通过环境变量处理
• 所有参数的输入验证
• 速率限制保护
• 安全的错误消息
• 基于角色的访问控制

许可证

MIT