MCP Server Hub

Servidor MCP centralizado hospedado no Vercel. Este servidor implementa o protocolo Model Context Protocol (MCP) para permitir que modelos de IA (como Claude, ChatGPT, etc.) interajam com vários serviços externos.

Serviços Implementados

• GitHub MCP: Permite interações com repositórios, issues, pull requests e outras funcionalidades do GitHub
• Web MCP: Permite buscas na web e recuperação de conteúdo de URLs
• Extensível: Estrutura pronta para adicionar mais servidores MCP conforme necessário

Como usar

Para conectar a este servidor MCP com qualquer cliente MCP (como Claude Desktop, VS Code, etc.), use a seguinte URL após o deploy:

https://mcp-server-hub.vercel.app/api/mcp

Configuração no VS Code

Para configurar o VS Code para usar este servidor MCP:

1. Abra as configurações (Ctrl+, ou Code > Preferences > Settings)
2. Procure por "MCP"
3. Adicione o seguinte nas configurações JSON:

{
  "mcp": {
    "servers": {
      "github": {
        "url": "https://mcp-server-hub.vercel.app/api/mcp"
      }
    }
  }
}

Configuração em outros clientes MCP

Para outros clientes que suportam MCP, configure como servidor personalizado usando a URL: https://mcp-server-hub.vercel.app/api/mcp

Variáveis de ambiente necessárias

Para usar todas as funcionalidades, configure as seguintes variáveis de ambiente no Vercel:

• GITHUB_TOKEN: Token pessoal do GitHub com permissões adequadas
• SEARCH_API_KEY: Chave para API de busca (opcional, dependendo do provedor)

Instalação local

Para testar o servidor localmente:

1. Clone este repositório
2. Execute npm install
3. Crie um arquivo .env.local com as variáveis necessárias
4. Execute npm run dev
5. O servidor estará disponível em: http://localhost:3000/api/mcp

Deploy no Vercel

1. Faça fork deste repositório (ou use diretamente este)
2. No Vercel, vá para "New Project" e importe o repositório
3. Configure as variáveis de ambiente:
   • GITHUB_TOKEN: Token pessoal do GitHub
   • SEARCH_API_KEY: Chave para API de busca (opcional)
4. Clique em "Deploy"
5. Após o deploy, use a URL fornecida para acessar o servidor MCP

Exemplos de uso

Pesquisar repositórios no GitHub

{
  "tool": "github_search_repositories",
  "params": {
    "query": "language:javascript stars:>1000",
    "per_page": 5
  }
}

Criar uma issue no GitHub

{
  "tool": "github_create_issue",
  "params": {
    "owner": "lrdspc",
    "repo": "mcp-server-hub",
    "title": "Adicionar mais funcionalidades MCP",
    "body": "Precisamos adicionar suporte para mais serviços MCP."
  }
}

Buscar conteúdo de URL

{
  "tool": "fetch_url",
  "params": {
    "url": "https://exemplo.com/pagina"
  }
}

Suporte e contribuições

Contribuições são bem-vindas através de pull requests. Para problemas ou sugestões, por favor abra uma issue no GitHub.