Futarquía MCP

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

Instrucciones de configuración

1. Clonar el repositorio:

git clone <repository-url>
cd futarchy-mcp

2. Instalar dependencias:

npm install

3. 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)

4. Inicie el servidor de desarrollo:

npm run dev

Related MCP server: Solana MCP Server

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

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

chmod +x setup.sh
./setup.sh

2. 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:

1. getDaos - Obtén todos los DAO del sistema Futarchy

2. getDao - Obtener un DAO específico por ID

3. getProposals : obtiene todas las propuestas para un DAO específico

4. getProposal - Obtener una propuesta específica por ID

5. 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 .

Función de análisis de sentimientos

El servidor MCP de Futarchy ahora incluye una herramienta de análisis de opiniones que analiza la opinión de los datos de Discord y Twitter para propuestas específicas. Esta función ayuda a comprender la opinión de la comunidad sobre las propuestas y permite tomar decisiones más informadas.

Cómo funciona

1. La herramienta de análisis de sentimientos recopila datos de Discord y Twitter sobre una propuesta específica.

2. Analiza el sentimiento utilizando técnicas de procesamiento del lenguaje natural.

3. Clasifica el sentimiento en diferentes categorías (Tokenomics, Parámetros de Protocolo, etc.).

4. Genera un resumen, puntos clave y preocupaciones basadas en el análisis.

5. Los resultados se presentan en un formato estructurado que los frontends pueden consumir fácilmente.

Ejemplo de respuesta

{
  "proposalId": "F3hsZzWinRAHbr6CUxdkUFBCH8qNk6Mi9Zfu3PMX49BC",
  "sentimentScore": -0.8,
  "primaryCategory": "Tokenomics",
  "categories": [
    {
      "name": "Tokenomics",
      "score": 0.4
    },
    {
      "name": "Protocol Upgrades",
      "score": 0.3
    },
    {
      "name": "Partnerships Integrations",
      "score": 0.2
    },
    {
      "name": "Protocol Parameters",
      "score": 0.1
    }
  ],
  "summary": "The proposal to launch a new Horizon token for the Aave ecosystem has faced significant backlash from the community...",
  "keyPoints": [
    "The proposed token launch is seen as unnecessary and potentially harmful to the Aave token and community.",
    "The revenue-sharing model is perceived as frontloaded and unfair, favoring early years when adoption and revenue may be low.",
    "There is a desire to maintain the Aave token as the primary governance and utility token for the ecosystem."
  ],
  "concerns": [
    "Dilution of the Aave token's value and attention.",
    "Misalignment of incentives with the proposed revenue-sharing model.",
    "Creation of a separate entity that could compete with the Aave ecosystem.",
    "Lack of transparency and community involvement in the decision-making process."
  ],
  "sources": {
    "discord": true,
    "twitter": true
  }
}

Cómo utilizar

Puede utilizar la herramienta de análisis de sentimientos en su servidor MCP de la siguiente manera:

const result = await mcp_futarchy_routes_getProposalSentiment({
  proposalId: "F3hsZzWinRAHbr6CUxdkUFBCH8qNk6Mi9Zfu3PMX49BC"
});

Esto devolverá el análisis de sentimiento para la propuesta especificada.