フタルキーMCP

Solana 上の Futarchy プロトコルと対話するためのサーバー実装。

セットアップ手順

リポジトリをクローンします。

git clone <repository-url>
cd futarchy-mcp

依存関係をインストールします:

npm install

RPC URL を設定します。
- src/server.tsを開く
- 接続初期化でRPC URLを更新します: GXP3
- 以下を使用できます:
  - メインネット: https://api.mainnet-beta.solana.com
  - Devnet: https://api.devnet.solana.com
  - または独自の RPC プロバイダー URL (これのみで機能します)
開発サーバーを起動します。

npm run dev

利用可能なルート

DAOルート

GET /daos - すべてのDAOを取得する
GET /daos/:id - IDで特定のDAOを取得する
GET /daos/:id/proposals - 特定のDAOのすべての提案を取得する
POST /daos/:id/proposals - DAO の新しい提案を作成します (DAO 作成ルートが存在しないため、現時点ではテストされていません)
- 体：
  { "descriptionUrl": "string", "baseTokensToLP": "number", "quoteTokensToLP": "number" }

提案ルート

GET /proposals/:id - IDで特定の提案を取得する

テスト

Postmanやcurlなどのツールを使用してルートをテストできます。サーバーはデフォルトでポート9000で動作します。

curl コマンドの例:

# Get all DAOs
curl http://localhost:9000/daos

# Get a specific DAO
curl http://localhost:9000/daos/<dao-address>

# Get proposals for a DAO
curl http://localhost:9000/daos/<dao-address>/proposals

# Create a new proposal
curl -X POST http://localhost:9000/daos/<dao-address>/proposals \
  -H "Content-Type: application/json" \
  -d '{
    "descriptionUrl": "https://example.com/proposal",
    "baseTokensToLP": 1000,
    "quoteTokensToLP": 1000
  }'

カーソル用MCPサーバー

このプロジェクトには、Cursor がカスタムツールを通じて Futarchy バックエンドと対話できるようにする MCP (Model Context Protocol) サーバーも含まれています。

MCPサーバーの設定

セットアップスクリプトを実行して依存関係をインストールし、プロジェクトをビルドし、カーソルを構成します。

chmod +x setup.sh
./setup.sh

または手動で設定します。
- 依存関係をインストールしてプロジェクトをビルドする: GXP8
- ~/.cursor/mcp.jsonを開くか作成します。
- 次の設定を追加します（必要に応じてパスを調整してください）：GXP9

カーソルでMCPサーバーを使用する

カーソルのチャットでは次のツールを使用できます。

getDaos - Futarchy システムからすべての DAO を取得します
getDao - IDで特定のDAOを取得する
getProposals - 特定のDAOのすべての提案を取得する
getProposal - IDで特定の提案を取得する
createProposal - DAO の新しい提案を作成する

たとえば、Cursor のチャットでは次のように言うことができます。

Use the getDaos tool to retrieve a list of all DAOs from the futarchy-routes backend.

MCP サーバーの詳細については、 src/mcp/README.mdを参照してください。