Bmorphism Manifold MCP Server

🚀 人形 manifold MCP 服务器

该服务器为人形 Manifold 市场提供统一的应用程序接口 (API)，用于与市场进行交互。其具备查看市场、下注、添加流动性等多种功能，为用户提供便捷的市场操作体验。

🚀 快速开始

若你想使用该服务器，可按照以下步骤进行安装：

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

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

✨ 主要特性

市场查看

通过 API 端点可获取市场信息，涵盖基本信息（ID、名称、描述）、当前概率分布、流动性池详情、下注情况以及资产信息等。支持使用查询参数，如 market_id（指定市场 ID）、user_id（指定用户 ID）、status（指定市场状态，进行中或已结束）。

下注操作

允许用户在市场中进行下注，支持单独下注、多人合单以及杠杆交易。输入参数包括必填的 market_id（目标市场 ID）、amount（投注金额）、side（"YES" 或 "NO"），还有可选的 limit_prob（限价概率，范围为 0.01 至 0.99）。

流动性管理

支持添加和移除流动性：

添加流动性

{
  market_id: string
  amount: number
}

移除流动性

{
  contract_id: string
  amount: number
}

🔧 技术细节

核心组件

输入验证

采用 Zod 库进行严格的数据校验，包括类型检查、范围校验以及必填字段验证。

API 安全

集成 JWT 认证机制，确保用户身份认证、操作授权以及请求签名验证。

错误处理

具备完善的错误处理框架：

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

📚 详细文档

代码结构

项目采用模块化设计：

• api/：API 接口定义
• models/：数据模型定义
• validators/：输入校验逻辑
• controllers/：业务逻辑控制器
• middleware/：中间件处理

贡献指南

欢迎社区贡献！优先考虑以下方向：

• 新功能开发
• 性能优化
• 安全性提升
• 文档完善

📄 许可证

本项目采用 MIT License。