MPC Tally API Server

MPC Tally API サーバー

Tally API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI エージェントが DAO のガバナンスデータ、提案、メタデータなどの情報を取得できます。

機能

• 人気順または探索状況順で DAO を一覧表示
• ソーシャルリンクやガバナンス情報を含む、DAO の包括的なメタデータを取得
• 大規模な結果セットに対応するページネーション
• TypeScript と GraphQL で構築
• Bun のテストランナーによる完全なテストカバレッジ

インストール

# Clone the repository
git clone https://github.com/yourusername/mpc-tally-api-server.git
cd mpc-tally-api-server

# Install dependencies
bun install

# Build the project
bun run build

設定

1. ルートディレクトリに .env ファイルを作成します：

TALLY_API_KEY=your_api_key_here

2. Tally から API キーを取得します

⚠️ セキュリティに関する注意：API キーは安全に保管してください：

• .env ファイルをコミットしないでください
• ログやエラーメッセージに API キーを表示しないでください
• API キーが漏えいした場合は、キーをローテーションしてください
• 設定には環境変数を使用してください

使用方法

サーバーの起動

# Start the server
bun run start

# Development mode with auto-reload
bun run dev

Claude Desktop の設定

以下を Claude Desktop の設定に追加します：

{
  "tally": {
    "command": "node",
    "args": [
      "/path/to/mpc-tally-api-server/build/index.js"
    ],
    "env": {
      "TALLY_API_KEY": "your_api_key_here"
    }
  }
}

利用可能なスクリプト

• bun run clean - ビルドディレクトリをクリーンアップ
• bun run build - プロジェクトをビルド
• bun run start - ビルド済みサーバーを実行
• bun run dev - 自動リロードを有効にして開発モードで実行
• bun test - テストを実行
• bun test --watch - ウォッチモードでテストを実行
• bun test --coverage - カバレッジ付きでテストを実行

API 関数

サーバーは以下の MCP 関数を公開します：

list_daos

指定された基準でソートした DAO を一覧表示します。

パラメーター：

• limit（任意）：返す DAO の最大数（デフォルト：20、最大：50）
• afterCursor（任意）：ページネーション用のカーソル
• sortBy（任意）：DAO のソート方法（デフォルト：popular）
  • 選択肢："id"、"name"、"explore"、"popular"

ライセンス

MIT