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: Apollo.io MCP Server

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

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

TALLY_API_KEY=your_api_key_here

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"