Futarquía MCP

Una implementación de servidor para interactuar con el protocolo Futarchy en Solana.

Instrucciones de configuración

Clonar el repositorio:

git clone <repository-url>
cd futarchy-mcp

Instalar dependencias:

npm install

Configurar la URL de RPC:
- Abrir src/server.ts
- Actualizar la URL de RPC en la inicialización de la conexión: GXP3
- Puedes utilizar:
  - Red principal: https://api.mainnet-beta.solana.com
  - Devnet: https://api.devnet.solana.com
  - O la URL de su propio proveedor de RPC (solo funciona con esto)
Inicie el servidor de desarrollo:

npm run dev

Rutas disponibles

Rutas DAO

GET /daos - Obtener todos los DAO
GET /daos/:id - Obtener un DAO específico por ID
GET /daos/:id/proposals - Obtener todas las propuestas para un DAO específico
POST /daos/:id/proposals - Crea una nueva propuesta para un DAO (no probado hasta ahora porque la ruta de creación de DAO no existe)
- Cuerpo:
  { "descriptionUrl": "string", "baseTokensToLP": "number", "quoteTokensToLP": "number" }

Rutas de propuesta

GET /proposals/:id - Obtener una propuesta específica por ID

Pruebas

Puedes probar las rutas con herramientas como Postman o curl. El servidor se ejecuta en el puerto 9000 por defecto.

Ejemplos de comandos 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
  }'

Servidor MCP para cursor

Este proyecto también incluye un servidor MCP (Protocolo de contexto de modelo) que permite a Cursor interactuar con el backend de Futarchy a través de herramientas personalizadas.

Configuración del servidor MCP

Ejecute el script de instalación para instalar dependencias, compilar el proyecto y configurar Cursor:

chmod +x setup.sh
./setup.sh

O configúrelo manualmente:
- Instalar dependencias y compilar el proyecto: GXP8
- Abra o cree ~/.cursor/mcp.json
- Agregue la siguiente configuración (ajuste la ruta según sea necesario): GXP9

Uso del servidor MCP en Cursor

Puedes utilizar las siguientes herramientas en el chat de Cursor:

getDaos - Obtén todos los DAO del sistema Futarchy
getDao - Obtener un DAO específico por ID
getProposals : obtiene todas las propuestas para un DAO específico
getProposal - Obtener una propuesta específica por ID
createProposal - Crea una nueva propuesta para una DAO

Por ejemplo, en el chat de Cursor, puedes decir:

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

Para obtener más detalles sobre el servidor MCP, consulte src/mcp/README.md .