Manifold Markets MCP Server

Manifold Markets MCP サーバー

Manifold Markets の予測市場を操作するための MCP サーバーです。このサーバーは、すっきりとした MCP インターフェースを通じて Manifold の機能を幅広く利用できるようにし、高度な市場操作と集合知の仕組みを実現します。

アーキテクチャ

このサーバーは、構造化されたツールシステムを通じて、Manifold Markets の API 機能を完全にマッピングします。

コアコンポーネント

• スキーマレイヤー：すべての操作に対応する Zod ベースの検証スキーマ
• API 統合：Manifold の REST エンドポイントへの直接マッピング
• ツールハンドラー：適切なエラー管理を伴うリクエスト処理
• 型安全性：完全な TypeScript 実装

ツールのカテゴリ

市場の作成と管理

• create_market：市場を作成します（BINARY、MULTIPLE_CHOICE、PSEUDO_NUMERIC、POLL）
• unresolve_market：解決済みの市場を未解決状態に戻します
• close_market：取引のために市場を閉鎖します
• add_answer：複数選択式の市場に選択肢を追加します

市場での操作

• follow_market：関心のある市場を追跡します
• react：市場やコメントに「いいね」または「よくないね」を付けます
• add_bounty：分析に対する報奨金を追加します
• award_bounty：価値ある貢献に報酬を与えます

取引操作

• place_bet：市場で取引を行います
• cancel_bet：指値注文をキャンセルします
• sell_shares：ポジションを清算します

流動性の管理

• add_liquidity：市場に流動性を提供します
• remove_liquidity：提供した流動性を引き出します

情報の取得

• search_markets：条件を指定して市場を検索します
• get_market：市場の詳細情報を取得します
• get_user：ユーザープロフィール情報を取得します
• get_positions：ポートフォリオを追跡します

ソーシャル機能

• send_mana：ユーザー間でマナを送金します

検証済みの機能

このサーバーは、包括的な一連の操作を通じてテストされています。

テスト済みの機能

1. 市場の発見とフォロー

   • ✅ 条件を指定した市場検索
   • ✅ 市場のフォロー
   • ✅ 市場の詳細情報の取得

2. 取引操作

   • ✅ 流動性の提供
   • ✅ 確率の更新を伴う賭けの実行
   • ✅ ポジションの清算
   • ✅ 株式の売却

3. 権限管理

   • ✅ ロールベースのアクセス制御
   • ✅ 認証処理
   • ✅ エラーメッセージ

権限による制限がある操作

以下の操作は実装されていますが、特定のユーザーロールが必要です。

• 市場の解決／未解決への変更（市場の作成者）
• 市場の閉鎖（市場の作成者）
• 報奨金の管理（市場の作成者）
• 流動性の引き出し（流動性の提供者）

前提条件

• Node.js 18 以上
• npm または yarn
• Manifold Markets API キー
• 市場の作成には最低 M$1000 の残高が必要です

インストール

1. パッケージをインストールする

npm install manifold-mcp-server

2. API キーを取得する

1. Manifold Markets にログインします
2. プロフィール設定を開きます
3. API キーを生成します
4. 実行する操作に十分なマナがアカウントにあることを確認します

3. MCP 設定を構成する

Claude Desktop の場合

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cline（VSCode 拡張機能）の場合

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

ツールのドキュメント

市場の作成と管理

create_market

新しい予測市場を作成します。

{
  outcomeType: 'BINARY' | 'MULTIPLE_CHOICE' | 'PSEUDO_NUMERIC' | 'POLL' | 'BOUNTIED_QUESTION'
  question: string
  description?: string | {
    type: 'doc'
    content: any[]
  }
  closeTime?: number // Unix timestamp ms
  visibility?: 'public' | 'unlisted'
  initialProb?: number // Required for BINARY (1-99)
  min?: number // Required for PSEUDO_NUMERIC
  max?: number // Required for PSEUDO_NUMERIC
  isLogScale?: boolean
  initialValue?: number // Required for PSEUDO_NUMERIC
  answers?: string[] // Required for MULTIPLE_CHOICE/POLL
  addAnswersMode?: 'DISABLED' | 'ONLY_CREATOR' | 'ANYONE'
  shouldAnswersSumToOne?: boolean
  totalBounty?: number // Required for BOUNTIED_QUESTION
}

unresolve_market

解決済みの市場を未解決状態に戻します。

{
  contractId: string
  answerId?: string // For multiple choice markets
}

close_market

取引のために市場を閉鎖します。

{
  contractId: string
  closeTime?: number // Optional close time
}

市場での操作

follow_market

市場をフォローまたはフォロー解除します。

{
  contractId: string
  follow: boolean
}

react

市場やコメントにリアクションします。

{
  contentId: string
  contentType: 'comment' | 'contract'
  remove?: boolean
  reactionType: 'like' | 'dislike'
}

取引操作

place_bet

市場で賭けを行います。

{
  marketId: string
  amount: number
  outcome: 'YES' | 'NO'
  limitProb?: number // 0.01-0.99
}

sell_shares

市場の株式を売却します。

{
  marketId: string
  outcome?: 'YES' | 'NO'
  shares?: number // Defaults to all
}

流動性の管理

add_liquidity

市場のプールに流動性を追加します。

{
  marketId: string
  amount: number
}

remove_liquidity

市場のプールから流動性を取り除きます。

{
  contractId: string
  amount: number
}

エラーハンドリング

サーバーでは、包括的なエラーハンドリングを実装しています。

1. 入力の検証

   • Zod スキーマによるパラメーター型のチェック
   • 値の範囲の検証
   • 必須フィールドの確認

2. API 通信

   • 認証エラー
   • ネットワーク障害
   • レート制限
   • 権限の確認

3. ビジネスロジック

   • 残高不足
   • 無効な市場状態
   • 未承認の操作

4. エラーレスポンス形式

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

開発

# Clone the repository
git clone https://github.com/bmorphism/manifold-mcp-server.git
cd manifold-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

貢献

貢献を歓迎します。関心のある分野は次のとおりです。

• 高度な市場分析ツール
• ポートフォリオ最適化機能
• 他の予測プラットフォームとの連携
• ドキュメントの改善

セキュリティ

• API キーは環境変数で管理します
• すべてのパラメーターで入力を検証します
• レート制限による保護
• 安全なエラーメッセージ
• ロールベースのアクセス制御

ライセンス

MIT