🚀 人形市场 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 调用错误处理、业务逻辑错误检查等，确保系统可靠性和数据安全性。
🔧 技术细节
拆解架构
该服务器基于模块化和可扩展的设计理念构建，主要组件包括：
- 核心控制模块：负责处理基础命令和协议。
- 市场数据模块：管理所有市场信息和交易数据。
- 用户交互模块：处理来自客户端的请求和指令。
- 安全验证模块：确保所有操作的安全性和合规性。
核心组件
- Zod 验证模式
- 所有输入参数均经过严格的类型检查和值域验证。
- 使用 Zod 库定义清晰的数据结构。
- 确保 API 请求的合法性。
- 市场数据处理
- 支持多链部署和跨平台交易。
- 提供实时市场监控和数据分析。
- 自动生成市场报告和统计信息。
- 协议执行引擎
- 负责处理复杂的市场操作逻辑。
- 确保所有交易按照规则正确执行。
- 提供完整的交易日志记录。
💻 使用示例
市场交互工具
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
}
📚 详细文档
错误处理
- 输入验证
- 所有参数均经过严格的类型检查。
- 确保数值在有效范围内。
- 验证必填字段的存在性。
- API 调用错误
- 捕捉所有网络异常和 API 错误。
- 提供详细的错误信息。
- 实现重试机制确保可靠性。
- 业务逻辑错误
- 检查市场状态和用户权限。
- 防止无效操作执行。
- 确保资金安全性和交易合法性。
贡献指南
欢迎贡献！以下是几个重点方向：
- 开发高级市场分析工具。
- 实现组合优化功能。
- 推动与其他预测平台的集成。
- 改进文档质量。
安全注意事项
- 所有 API 密钥均通过环境变量管理。
- 输入参数严格验证。
- 实施速率限制保护。
- 确保错误信息安全。
- 采用基于角色的访问控制。
📄 许可证
MIT License