Servidor PulseMCP

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

Características

• Lista de servidores MCP disponibles con filtrado y paginación

• Busque servidores MCP específicos por nombre o funcionalidad

• Filtrar servidores por tipos de integración

• Lista de todas las integraciones disponibles

• Compatibilidad total con TypeScript

Related MCP server: Notes MCP Server

Instalación

Instalación en clientes MCP

Agregue esto a la configuración de su cliente MCP y adáptelo según sus preferencias. Por ejemplo:

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

1. Clonar el repositorio:

git clone <repository-url>
cd pulsemcp-server

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Uso

Ejecución del servidor

El servidor se puede ejecutar directamente después de la compilación:

./build/index.js

O a través de npm:

npm start

Desarrollo

Para observar los cambios durante el desarrollo:

npm run watch

Para inspeccionar la implementación de MCP del servidor:

npm run inspector

Herramientas disponibles

servidores de lista

Enumera 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 por

• 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
}

integraciones de lista

Enumera todas las integraciones disponibles. Esta herramienta no admite 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 de API

• Limitación de velocidad

• Errores de autenticación

Los errores se devuelven en un formato estandarizado con códigos de error y mensajes 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

• ejes: ^1.7.9

• Tipo de script: ^5.3.3

Licencia

Lea LICENCIA.MD

Contribuyendo

Abra una PR: ¡sé amable y serás recompensado!