PulseMCP Server

PulseMCP Server

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para descubrir y explorar servidores MCP e integraciones a través de la API de PulseMCP.

Características

• Listar servidores MCP disponibles con filtrado y paginación
• Buscar servidores MCP específicos por nombre o funcionalidad
• Filtrar servidores por tipos de integración
• Listar todas las integraciones disponibles
• Soporte completo de TypeScript

Instalación

Instalación en clientes MCP

Añade esto a la configuración de tu cliente MCP y adáptalo según las preferencias de tu cliente. Por ejemplo:

{
  "mcpServers": {
    "pulsemcp": {
      "command": "npx",
      "args": ["-y", "pulsemcp-server"]
    }
  }
}

1. Clona el repositorio:

git clone <repository-url>
cd pulsemcp-server

2. Instala las dependencias:

npm install

3. Construye el proyecto:

npm run build

Uso

Ejecutar el servidor

El servidor se puede ejecutar directamente después de compilar:

./build/index.js

O a través de npm:

npm start

Desarrollo

Para observar cambios durante el desarrollo:

npm run watch

Para inspeccionar la implementación MCP del servidor:

npm run inspector

Herramientas disponibles

list_servers

Lista los servidores MCP con filtrado y paginación opcionales.

Parámetros:

• query (opcional): Término de búsqueda para filtrar servidores
• integrations (opcional): Matriz de slugs de integración para filtrar
• count_per_page (opcional): Número de resultados por página (máximo: 5000)
• offset (opcional): Número de resultados a omitir para la paginación

Ejemplo:

{
  "query": "toolhouse",
  "integrations": ["github"],
  "count_per_page": 10,
  "offset": 0
}

list_integrations

Lista todas las integraciones disponibles. Esta herramienta no acepta parámetros.

Formato de respuesta

Ambas herramientas devuelven respuestas JSON con la siguiente estructura:

Respuesta de list_servers

{
  "servers": [
    {
      "name": "Server Name",
      "url": "https://example.com",
      "external_url": "https://external-link.com",
      "short_description": "Server description",
      "source_code_url": "https://github.com/example/repo",
      "github_stars": 123,
      "package_registry": "npm",
      "package_name": "package-name",
      "package_download_count": 1000,
      "integrations": [
        {
          "name": "Integration Name",
          "slug": "integration-slug",
          "url": "https://integration-url.com"
        }
      ]
    }
  ],
  "total_count": 1,
  "next": null
}

Respuesta de list_integrations

{
  "integrations": [
    {
      "name": "Integration Name",
      "slug": "integration-slug",
      "url": "https://integration-url.com"
    }
  ]
}

Manejo de errores

El servidor incluye un manejo robusto de errores para:

• Parámetros no válidos
• Problemas de conexión con la API
• Limitación de velocidad
• Errores de autenticación

Los errores se devuelven en un formato estandarizado con códigos y mensajes de error apropiados.

Desarrollo

Estructura del proyecto

pulsemcp-server/
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json    # Project configuration
└── tsconfig.json   # TypeScript configuration

Dependencias

• @modelcontextprotocol/sdk: ^0.6.0
• axios: ^1.7.9
• TypeScript: ^5.3.3

Licencia

Lea LICENSE.MD

Contribuciones

¡Abre un PR - sé amable y serás recompensado!