Manifold Markets MCP Server

Manifold Markets MCP 服务

一个用于与 Manifold Markets 预测市场交互的 MCP 服务。此服务通过简洁的 MCP 接口全面提供 Manifold 的各项功能，支持复杂的市场交互和集体智能机制。

架构

此服务通过结构化的工具系统，完整映射 Manifold Markets API 的功能：

核心组件

• 架构层：基于 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 扩展）

添加到 ~/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 timestamp ms
  visibility?: 'public' | 'unlisted'
  initialProb?: number // Required for BINARY (1-99)
  min?: number // Required for PSEUDO_NUMERIC
  max?: number // Required for PSEUDO_NUMERIC
  isLogScale?: boolean
  initialValue?: number // Required for PSEUDO_NUMERIC
  answers?: string[] // Required for MULTIPLE_CHOICE/POLL
  addAnswersMode?: 'DISABLED' | 'ONLY_CREATOR' | 'ANYONE'
  shouldAnswersSumToOne?: boolean
  totalBounty?: number // Required for BOUNTIED_QUESTION
}

unresolve_market

撤销先前已结算市场的结算：

{
  contractId: string
  answerId?: string // For multiple choice markets
}

close_market

关闭市场交易：

{
  contractId: string
  closeTime?: number // Optional close time
}

市场互动

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 // Defaults to all
}

流动性管理

add_liquidity

向市场资金池添加流动性：

{
  marketId: string
  amount: number
}

remove_liquidity

从市场资金池移除流动性：

{
  contractId: string
  amount: number
}

错误处理

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

1. 输入验证

   • 通过 Zod 架构检查参数类型
   • 验证值范围
   • 验证必填字段

2. API 通信

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

3. 业务逻辑

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

4. 错误响应格式

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

开发

# Clone the repository
git clone https://github.com/bmorphism/manifold-mcp-server.git
cd manifold-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

贡献

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

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

安全

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

许可证

MIT