Servidor API de tally de MPC

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Tally. Este servidor permite a los agentes de IA obtener información sobre las DAO, incluyendo sus datos de gobernanza, propuestas y metadatos.

Características

• Lista de DAO ordenadas por popularidad o estado de exploración

• Obtenga metadatos DAO completos, incluidos enlaces sociales e información de gobernanza

• Soporte de paginación para manejar grandes conjuntos de resultados

• Desarrollado con TypeScript y GraphQL

• Cobertura completa de la prueba con el corredor de pruebas de Bun

Related MCP server: mcp-graphql

Instalación

# 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

Configuración

1. Cree un archivo .env en el directorio raíz:

TALLY_API_KEY=your_api_key_here

2. Obtén tu clave API de Tally

⚠️ Nota de seguridad : Mantenga su clave API segura:

• Nunca confirmes tu archivo .env

• No exponga su clave API en registros o mensajes de error

• Rote su clave API si alguna vez se expone

• Utilice variables de entorno para la configuración

Uso

Ejecución del servidor

# Start the server
bun run start

# Development mode with auto-reload
bun run dev

Configuración del escritorio de Claude

Agregue lo siguiente a su configuración de Claude Desktop:

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

Scripts disponibles

• bun run clean - Limpia el directorio de compilación

• bun run build - Construye el proyecto

• bun run start - Ejecuta el servidor compilado

• bun run dev - Ejecutar en modo de desarrollo con recarga automática

• bun test - Ejecutar pruebas

• bun test --watch - Ejecuta pruebas en modo de vigilancia

• bun test --coverage - Ejecutar pruebas con cobertura

Funciones API

El servidor expone las siguientes funciones MCP:

lista_daos

Enumera las DAO ordenadas según criterios específicos.

Parámetros:

• limit (opcional): número máximo de DAO a devolver (predeterminado: 20, máximo: 50)

• afterCursor (opcional): Cursor para paginación

• sortBy (opcional): Cómo ordenar los DAO (predeterminado: popular)

  • Opciones: "id", "nombre", "explorar", "popular"

Licencia

Instituto Tecnológico de Massachusetts (MIT)