PulseMCP Server

PulseMCP Server

Um servidor Model Context Protocol (MCP) que fornece ferramentas para descobrir e explorar servidores e integrações MCP através da API PulseMCP.

Recursos

• Listar servidores MCP disponíveis com filtragem e paginação
• Buscar servidores MCP específicos por nome ou funcionalidade
• Filtrar servidores por tipos de integração
• Listar todas as integrações disponíveis
• Suporte completo a TypeScript

Instalação

Instalando em Clientes MCP

Adicione isto à configuração do seu cliente MCP e adapte conforme as preferências do seu Cliente. Por exemplo:

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

1. Clone o repositório:

git clone <repository-url>
cd pulsemcp-server

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Uso

Executando o Servidor

O servidor pode ser executado diretamente após a compilação:

./build/index.js

Ou através do npm:

npm start

Desenvolvimento

Para observar alterações durante o desenvolvimento:

npm run watch

Para inspecionar a implementação MCP do servidor:

npm run inspector

Ferramentas Disponíveis

list_servers

Lista servidores MCP com filtragem e paginação opcionais.

Parâmetros:

• query (opcional): Termo de busca para filtrar servidores
• integrations (opcional): Matriz de slugs de integração para filtrar
• count_per_page (opcional): Número de resultados por página (máximo: 5000)
• offset (opcional): Número de resultados a pular para paginação

Exemplo:

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

list_integrations

Lista todas as integrações disponíveis. Esta ferramenta não aceita parâmetros.

Formato de Resposta

Ambas as ferramentas retornam respostas JSON com a seguinte estrutura:

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

Resposta de list_integrations

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

Tratamento de Erros

O servidor inclui tratamento robusto de erros para:

• Parâmetros inválidos
• Problemas de conexão com a API
• Limitação de taxa
• Erros de autenticação

Os erros são retornados em um formato padronizado com códigos e mensagens de erro apropriados.

Desenvolvimento

Estrutura do Projeto

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

Dependências

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

Licença

Leia LICENSE.MD

Contribuição

Abra um PR - seja gentil e você será recompensado!