MCP Pool

MCP Pool

Documentation | npm | GitHub

Uma coleção curada de servidores Model Context Protocol (MCP) que dão aos assistentes de IA acesso direto a APIs SaaS populares — sem necessidade de alternar entre painéis.

O MCP Pool preenche a lacuna entre interfaces de chat de IA e as ferramentas empresariais que as equipes usam diariamente. Faça perguntas em linguagem natural e obtenha respostas reais baseadas em dados ao vivo.

---

Pacotes

Pacote	Descrição	Versão
@vineethnkrishnan/stripe-mcp	Stripe — pagamentos, clientes, assinaturas, faturas
@vineethnkrishnan/sentry-mcp	Sentry — issues, eventos, stack traces. Suporte para self-hosted.
@vineethnkrishnan/notion-mcp	Notion — páginas, bancos de dados, busca, conteúdo
@vineethnkrishnan/linear-mcp	Linear — issues, projetos, equipes (GraphQL)
@vineethnkrishnan/datadog-mcp	Datadog — monitores, métricas, eventos. Suporte a múltiplos sites.
@vineethnkrishnan/vercel-mcp	Vercel — deployments, projetos, logs de build
@vineethnkrishnan/pagerduty-mcp	PagerDuty — incidentes, plantão, serviços. Suporte para a UE.
@vineethnkrishnan/hubspot-mcp	HubSpot — contatos, negócios, empresas
@vineethnkrishnan/intercom-mcp	Intercom — conversas, contatos, suporte
@vineethnkrishnan/shopify-mcp	Shopify — pedidos, produtos, clientes
@vineethnkrishnan/google-workspace-mcp	Google Workspace — Gmail, Calendar, Drive, Sheets

---

Início Rápido

Pré-requisitos

• Node.js >= 20 (veja .nvmrc)

Usar com o Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@vineethnkrishnan/stripe-mcp"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Depois, pergunte ao Claude coisas como:

• "Quantas assinaturas ativas temos?"
• "Por que o último pagamento de cus_123 falhou?"
• "Mostre-me nosso saldo atual no Stripe."

---

Desenvolvimento

# Clone and install
git clone https://github.com/vineethkrishnan/mcp-pool.git
cd mcp-pool
npm install

Comando	Descrição
npm run build	Compilar todos os pacotes
npm test	Executar testes em todos os pacotes
npm run lint:check	Lint com ESLint
npm run format:check	Verificar formatação com Prettier
npm run docs:start	Iniciar servidor de desenvolvimento da documentação

---

Estrutura do Projeto

mcp-pool/
├── packages/
│   ├── oauth-core/          # Shared OAuth 2.0 infrastructure
│   │   └── src/
│   │       ├── strategies/  # OAuth & static token strategies
│   │       └── cli/         # Auth login/logout CLI helpers
│   └── <server>/            # MCP server (×11)
│       └── src/
│           ├── index.ts     # MCP server entry point
│           ├── services/    # API SDK wrapper
│           ├── tools/       # MCP tool definitions
│           └── common/      # Shared types & utilities
├── docs/                    # Docusaurus documentation site
├── .github/workflows/       # CI, quality, security, release
└── package.json             # Monorepo root (npm workspaces)

---

CI/CD

Workflow	Trigger	O que faz
CI	Push / PR para main	Lint, testes (Node 20 + 22), build
Quality	Push / PR para main	Detecção de código morto (knip), duplicação de código (jscpd)
Security	Push / PR / semanal	Análise CodeQL, revisão de dependências, varredura Trivy
Commit Lint	PR	Valida se o título do PR segue Conventional Commits
Release	Push para main	Versionamento com release-please, publicação no npm, deploy da documentação

---

Adicionar um Novo Servidor MCP

1. Crie packages/<name>/ seguindo a estrutura em packages/stripe/
2. Implemente uma camada de serviço (wrapper de API) e uma camada de ferramentas (interface MCP)
3. Adicione testes — busque cobertura completa
4. Adicione a entrada do pacote em release-please-config.json e .release-please-manifest.json
5. Adicione páginas de documentação em docs/

Veja CONTRIBUTING.md para diretrizes completas.

---

Convenção de Commits

Todos os commits seguem Conventional Commits:

feat(stripe): add refund support
fix(stripe): handle null customer email
docs: update installation guide

Aplicado via commitlint + hooks de pre-commit do husky.

---

Documentação

Visite o site de documentação para guias detalhados sobre cada servidor MCP.

---

Roadmap

Veja o roadmap para funcionalidades planejadas e marcos futuros:

• v0.2.0 — Operações de escrita, transporte SSE, respostas em streaming
• v0.3.0 — Webhooks, múltiplas contas, cobertura expandida de API, novos servidores

---

Licença

MIT — Vineeth Krishnan