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 調用錯誤、業務邏輯錯誤等方面，提供詳細的錯誤信息和重試機制，確保系統的可靠性。

📦 安裝指南

# 克隆倉庫
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