🚀 人形市场 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 调用错误、业务逻辑错误等方面，提供详细的错误信息和重试机制，确保系统的可靠性。

📦 安装指南

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

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行测试
npm test

💻 使用示例

市场交互工具

基础用法

// 创建新市场
{
  title: string
  description: string
  marketType: "prediction" | "binary" | "custom"
  parameters: {
    [key: string]: any
  }
}

// 查询市场信息
{
  contractId: string
  fields?: string[]
}

// 修改现有市场
{
  contractId: string
  updates: {
    [key: string]: any
  }
}

高级用法

// 这里可以根据实际的高级场景进行说明

市场操作工具

基础用法

// 下注交易
{
  marketId: string
  amount: number
  outcome: "YES" | "NO"
  prob?: number
}

// 转让股份
{
  marketId: string
  recipient: string
  shares: number
}

// 撤销订单
{
  orderId: string
  撤单原因?: string
}

高级用法

// 这里可以根据实际的高级场景进行说明

📚 详细文档

拆解架构

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

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

核心组件

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

工具类别

市场交互工具

• 创建新市场：通过指定市场的标题、描述、类型和参数等信息来创建新的市场。
• 查询市场信息：根据合约 ID 和可选的字段列表查询市场的相关信息。
• 修改现有市场：根据合约 ID 和更新内容对现有市场进行修改。

市场操作工具

• 下注交易：在指定市场进行下注操作，指定下注金额、结果和可选的概率。
• 转让股份：将指定市场的股份转让给其他用户。
• 撤销订单：根据订单 ID 撤销指定的订单，并可提供撤单原因。

错误处理

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

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

🔧 技术细节

该服务器在设计和实现过程中采用了一系列先进的技术和理念，以确保系统的高效性、可靠性和安全性。例如，在架构设计上采用模块化和可扩展的方式，使得各个组件可以独立开发和维护；在输入验证方面，使用 Zod 库对所有输入参数进行严格的类型检查和值域验证，确保 API 请求的合法性；在错误处理方面，全面覆盖输入验证、API 调用错误和业务逻辑错误等方面，并提供详细的错误信息和重试机制，确保系统的可靠性。

🤝 贡献指南

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

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

⚠️ 安全注意事项

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

📄 许可证

MIT License