未来 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
  - 开发网： 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 服务器

该项目还包括一个 MCP（模型上下文协议）服务器，允许 Cursor 通过自定义工具与 Futarchy 后端进行交互。

设置 MCP 服务器

运行安装脚本来安装依赖项、构建项目并配置 Cursor：

chmod +x setup.sh
./setup.sh

或者手动配置：
- 安装依赖项并构建项目：GXP8
- 打开或创建~/.cursor/mcp.json
- 添加以下配置（根据需要调整路径）：GXP9

在 Cursor 中使用 MCP 服务器

您可以在 Cursor 的聊天中使用以下工具：

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 。