Bmorphism Manifold MCP Server

🚀 人形 manifold MCP サーバー

このサーバーは、Manifold マーケットとのインタラクションに使用する統一されたアプリケーションインターフェース (API) を提供します。以下の機能をサポートしています。

• マーケットの閲覧
• 賭け
• 流動性の追加
• マーケットのフォロー
• 反応（いいね/悪いね）
• マーケットの解除

🚀 クイックスタート

このサーバーを使用することで、Manifold マーケットとのやり取りを容易に行うことができます。以下のセクションでは、各機能の詳細と使い方を説明します。

✨ 主な機能

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 認証メカニズムを統合し、以下を保証します。

• ユーザーの身元認証
• 操作の承認
• リクエストの署名検証

3. エラー処理

完全なエラー処理フレームワークが用意されています。

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

📦 インストール

# リポジトリをクローンする
git clone https://github.com/bmorphism/manifold-mcp-server.git
cd manifold-mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# テストを実行する
npm test

📚 ドキュメント

コード構造

このプロジェクトはモジュール化設計を採用しています。

• api/：API インターフェースの定義
• models/：データモデルの定義
• validators/：入力検証ロジック
• controllers/：ビジネスロジックのコントローラー
• middleware/：ミドルウェアの処理

貢献ガイド

コミュニティからの貢献を歓迎します！以下の方向が優先されます。

• 新機能の開発
• パフォーマンスの最適化
• セキュリティの向上
• ドキュメントの充実

📄 ライセンス

MIT License