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

✨ 主要特性

1. 市場查看

通過 API 端點可獲取市場信息，涵蓋基本信息（ID、名稱、描述）、當前概率分佈、流動性池詳情、下注情況以及資產信息等。支持使用查詢參數 market_id（指定市場 ID）、user_id（指定用戶 ID）、status（指定市場狀態，如進行中、已結束）進行精準查詢。

2. 下注操作

允許用戶在市場中進行下注，支持單獨下注、多人合單以及槓桿交易。輸入參數包括必填的 market_id（目標市場 ID）、amount（投注金額）、side（"YES" 或 "NO"），以及可選的 limit_prob（限價概率，範圍為 0.01 至 0.99）。

3. 流動性管理

支持添加和移除流動性：

添加流動性

{
  market_id: string
  amount: number
}

移除流動性

{
  contract_id: string
  amount: number
}

🔧 技術細節

1. 輸入驗證

採用 Zod 庫進行嚴格的數據校驗，包括類型檢查、範圍校驗以及必填字段驗證，確保輸入數據的準確性和完整性。

2. API 安全

集成 JWT 認證機制，保障用戶身份認證、操作授權以及請求籤名驗證，確保 API 操作的安全性。

3. 錯誤處理

擁有完善的錯誤處理框架，以如下格式返回錯誤信息：

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

📚 詳細文檔

代碼結構

項目採用模塊化設計，各模塊分工明確：

• api/：負責 API 接口定義。
• models/：進行數據模型定義。
• validators/：處理輸入校驗邏輯。
• controllers/：實現業務邏輯控制。
• middleware/：進行中間件處理。

貢獻指南

歡迎社區貢獻！優先考慮以下貢獻方向：

• 新功能開發
• 性能優化
• 安全性提升
• 文檔完善

📄 許可證

本項目採用 MIT License。