Manifold MCP Server

🚀 人形市场 MCP 服务器

人形市场 MCP 服务器用于与人形市场预测市场进行交互。通过简洁的 MCP 接口，该服务器可全面访问人形市场的功能，还支持多种工具和服务。

🚀 快速开始

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

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行测试
npm test

✨ 主要特性

• 基于模块化和可扩展的设计理念构建，包含核心控制、市场数据、用户交互和安全验证等主要组件。
• 采用 Zod 验证模式，对所有输入参数进行严格的类型检查和值域验证，确保 API 请求合法。
• 支持多链部署和跨平台交易，提供实时市场监控和数据分析，自动生成市场报告和统计信息。
• 具备协议执行引擎，处理复杂的市场操作逻辑，确保交易按规则正确执行，并提供完整的交易日志记录。
• 提供丰富的市场交互和操作工具，涵盖创建、查询、修改市场，以及下注交易、转让股份、撤销订单等功能。
• 完善的错误处理机制，包括输入验证、API 调用错误处理、业务逻辑错误检查等，确保系统可靠性和数据安全性。

🔧 技术细节

拆解架构

该服务器基于模块化和可扩展的设计理念构建，主要组件包括：

• 核心控制模块：负责处理基础命令和协议。
• 市场数据模块：管理所有市场信息和交易数据。
• 用户交互模块：处理来自客户端的请求和指令。
• 安全验证模块：确保所有操作的安全性和合规性。

核心组件

1. Zod 验证模式
   • 所有输入参数均经过严格的类型检查和值域验证。
   • 使用 Zod 库定义清晰的数据结构。
   • 确保 API 请求的合法性。
2. 市场数据处理
   • 支持多链部署和跨平台交易。
   • 提供实时市场监控和数据分析。
   • 自动生成市场报告和统计信息。
3. 协议执行引擎
   • 负责处理复杂的市场操作逻辑。
   • 确保所有交易按照规则正确执行。
   • 提供完整的交易日志记录。

💻 使用示例

市场交互工具

1. 创建新市场

{
  title: string
  description: string
  marketType: "prediction" | "binary" | "custom"
  parameters: {
    [key: string]: any
  }
}

2. 查询市场信息

{
  contractId: string
  fields?: string[]
}

3. 修改现有市场

{
  contractId: string
  updates: {
    [key: string]: any
  }
}

市场操作工具

1. 下注交易

{
  marketId: string
  amount: number
  outcome: "YES" | "NO"
  prob?: number
}

2. 转让股份

{
  marketId: string
  recipient: string
  shares: number
}

3. 撤销订单

{
  orderId: string
  撤单原因?: string
}

错误响应格式

{
  code: 错误码
  message: string
  details?: any
}

📚 详细文档

错误处理

1. 输入验证
   • 所有参数均经过严格的类型检查。
   • 确保数值在有效范围内。
   • 验证必填字段的存在性。
2. API 调用错误
   • 捕捉所有网络异常和 API 错误。
   • 提供详细的错误信息。
   • 实现重试机制确保可靠性。
3. 业务逻辑错误
   • 检查市场状态和用户权限。
   • 防止无效操作执行。
   • 确保资金安全性和交易合法性。

贡献指南

欢迎贡献！以下是几个重点方向：

• 开发高级市场分析工具。
• 实现组合优化功能。
• 推动与其他预测平台的集成。
• 改进文档质量。

安全注意事项

• 所有 API 密钥均通过环境变量管理。
• 输入参数严格验证。
• 实施速率限制保护。
• 确保错误信息安全。
• 采用基于角色的访问控制。

📄 许可证

MIT License