MCP SuperAssistant Chrome Extension

Leva MCP para ChatGPT, Perplexity, Grok, Gemini, Google AI Studio, OpenRouter, Kimi, Github Copilot, Mistral e mais...

🌐 Visite o Site Oficial

Instalação

Visão Geral

O MCP SuperAssistant é uma extensão do Chrome que integra as ferramentas do Model Context Protocol (MCP) com plataformas de IA como Perplexity, ChatGPT, Google Gemini, Google AI Studio, Grok e outras. Ele permite que os usuários executem ferramentas MCP diretamente dessas plataformas, aprimorando as capacidades dos assistentes de IA baseados na web.

Plataformas Atualmente Suportadas

• ChatGPT
• Google Gemini
• Perplexity
• Grok
• Google AI Studio
• OpenRouter Chat
• DeepSeek
• T3 Chat
• GitHub Copilot
• Mistral AI
• Kimi
• Qwen Chat
• Z Chat

Vídeo de Demonstração

Kimi.com

ChatGPT

Assista à demonstração para ver o MCP SuperAssistant em ação!

MCP SuperAssistant Demo Playlist

Tutorial de Configuração

Novo no MCP SuperAssistant? Assista a este guia de configuração completo para começar em minutos!

Ver Tutorial de Configuração

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto desenvolvido pela Anthropic que conecta assistentes de IA a sistemas onde os dados realmente residem, incluindo repositórios de conteúdo, ferramentas de negócios e ambientes de desenvolvimento. Ele serve como um protocolo universal que permite que sistemas de IA interajam de forma segura e dinâmica com fontes de dados em tempo real.

Principais Recursos

• Suporte a Múltiplas Plataformas de IA: Funciona com ChatGPT, Perplexity, Google Gemini, Grok, Google AI Studio, OpenRouter Chat, DeepSeek, Kagi, T3 Chat, GitHub Copilot, Mistral AI, Kimi, Qwen Chat, Z Chat e mais.
• Detecção de Ferramentas: Detecta automaticamente chamadas de ferramentas MCP nas respostas de IA.
• Execução de Ferramentas: Execute ferramentas MCP com um único clique.
• Integração de Resultados de Ferramentas: Insira perfeitamente os resultados da execução de ferramentas de volta na conversa de IA.
• Modo de Renderização: Renderiza chamadas de função e resultados de função.
• Modo de Execução Automática: Execute automaticamente as ferramentas detectadas.
• Modo de Envio Automático: Envie automaticamente a entrada do chat após a inserção do resultado.
• Modo de Conteúdo Push: Opção de enviar o conteúdo da página em vez de sobrepor.
• Persistência de Preferências: Lembra a posição, o tamanho e as configurações da barra lateral.
• Suporte a Modo Escuro/Claro: Adapta-se ao tema da plataforma de IA.

flowchart TD
    A[AI Chat Interface] -->|Generate| B[Tool Calls]
    B -->|Detect| C[Extension Detects Tool Calls]
    C -->|Send via SSE| D[MCP Local Proxy Server]
    D -->|Forward| E[Actual MCP Server]
    E -->|Return Results| D
    D -->|Return Results| C
    C -->|Insert| F[Add Results Back to Chat]

Conectando ao Servidor Proxy Local

Para conectar a extensão do Chrome a um servidor local para proxy de conexões:

Execute o Proxy MCP SuperAssistant via npx:

1. Crie um arquivo config.json com os detalhes do seu servidor MCP. Por exemplo, para usar o Desktop Commander:

   Exemplo de config.json:

   {
     "mcpServers": {
       "desktop-commander": {
         "command": "npx",
         "args": [
           "-y",
           "@wonderwhy-er/desktop-commander"
         ]
       }
     }
   }
   

   config.json também suporta outras configurações de servidor MCP, como URLs de servidores MCP remotos. Tente composio mcp, zappier mcp, ou smithery ou qualquer outro servidor MCP remoto.

   Ou use o local do arquivo de configuração existente do Cursor ou outras ferramentas:

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: %APPDATA%\Claude\claude_desktop_config.json
   

2. Inicie o servidor proxy MCP SuperAssistant usando um dos seguintes comandos:

   npx -y @srbhptl39/mcp-superassistant-proxy@latest --config ./config.json --outputTransport sse
   

   ou

   npx -y @srbhptl39/mcp-superassistant-proxy --config ./config.json --outputTransport streamableHttp
   

   ou

   npx -y @srbhptl39/mcp-superassistant-proxy --config ./config.json --outputTransport ws
   

   Veja todas as opções disponíveis:

   npx -y @srbhptl39/mcp-superassistant-proxy@latest --help
   

   Isso é útil para:

   • Fazer proxy de servidores MCP remotos
   • Adicionar suporte CORS a servidores remotos
   • Fornecer endpoints de saúde para monitoramento

Etapas de Conexão:

1. Inicie o servidor proxy usando um dos comandos acima
2. Abra a barra lateral do MCP SuperAssistant em uma das plataformas de IA suportadas; isso deve mostrar a interface da barra lateral
3. Clique no indicador de status do servidor (geralmente mostrando "Desconectado")
4. Insira a URL do servidor local (padrão: http://localhost:3006/sse) O formato da URL depende do método --outputTransport usado:
   • Para SSE: http://localhost:3006/sse
   • Para Streamable HTTP: http://localhost:3006/mcp
   • Para WebSocket: ws://localhost:3006/message
   • Escolha o método de transporte apropriado (SSE ou Streamable HTTP ou WebSocket)
   • Você também pode adicionar qualquer URL de servidor MCP remoto aqui, se ele suportar CORS ou for proxy via este servidor proxy local. Tente Composio mcp, Zappier mcp ou smithery ou qualquer outro servidor MCP remoto.
5. Clique em "Conectar" para estabelecer a conexão
6. O indicador de status deve mudar para "Conectado" se for bem-sucedido

Uso

Exemplo de Fluxo de Trabalho:

1. Navegue até uma plataforma de IA suportada, por exemplo, ChatGPT.
2. A barra lateral do MCP SuperAssistant aparecerá no lado direito da página.
3. Configure suas Ferramentas MCP para habilitar e desabilitar as ferramentas que deseja usar.
4. Na área de prompt de mensagem, passe o mouse sobre o botão 'MCP' para ver as ferramentas disponíveis e suas descrições.
5. O MCP SuperAssistant requer adicionar um prompt de instruções de trabalho MCP ao chat, para dar detalhes de suas novas capacidades e como usar as ferramentas. Use o botão 'Inserir' ou anexar para adicionar o prompt de instruções.
6. Depois que o prompt de instruções for adicionado, agora você pode pedir para ler arquivos ou qualquer operação relacionada às ferramentas MCP.
7. Quando a IA quiser usar qualquer ferramenta, ela mostrará um cartão de chamada de ferramenta personalizado com o nome e os parâmetros da ferramenta.
8. O usuário pode executar manualmente a chamada de ferramenta clicando no botão "RUN" no cartão de chamada de ferramenta, ou se o modo Auto-Execute estiver habilitado, ele será executado automaticamente.
9. A automação pode ser alcançada habilitando os modos Auto-Execute e Auto-Submit, clicando no botão 'MCP' e configurando os modos Auto.

Dicas e Truques

1. Desative o modo de pesquisa (chatgpt, perplexity) nas interfaces de chat de IA para uma melhor experiência de prompt de chamada de ferramenta e para evitar que o MCP SuperAssistant saia dos trilhos.
2. Ative o modo de raciocínio (chatgpt, perplexity, grok) nas interfaces de chat de IA, o que ajudará a IA a entender melhor o contexto e gerar as chamadas de ferramenta corretas.
3. Use modelos mais novos e de alta qualidade, pois eles são melhores em entender o contexto e gerar as chamadas de ferramenta corretas.
4. Copie o prompt de instruções MCP e cole-o no prompt do sistema de chat de IA (Google AI Studio).
5. Mencione as ferramentas específicas que deseja usar em sua conversa.
6. Use os alternadores MCP Auto para controlar a execução da ferramenta.

Problemas Comuns com o MCP SuperAssistant

Esta página cobre os problemas mais comuns que os usuários encontram com o MCP SuperAssistant e fornece soluções para resolvê-los.

1. Extensão Não Detectando Chamadas de Ferramentas

• Certifique-se de que a extensão esteja habilitada no seu navegador.
• Certifique-se de que as instruções do prompt mcp estejam devidamente anexadas ou inseridas no chat, antes de iniciar qualquer chat.
• Verifique se sua plataforma de IA suporta chamadas de ferramentas e se o recurso está habilitado.
• Atualize a página ou reinicie o navegador se o problema persistir.

2. Falha na Execução de Ferramentas

• Certifique-se de que seu servidor proxy esteja em execução e que a URL esteja correta nas configurações do servidor da barra lateral.
• Verifique seu arquivo config.json para erros ou problemas de formatação.
• Verifique sua conectividade de rede e configurações de firewall.

3. Problemas de Conexão

• Certifique-se de que seu servidor MCP esteja em execução e acessível.
• Verifique a URL do servidor nas configurações da extensão.
• Primeiro inicie o servidor npx mcp-SuperAssistant-proxy e depois recarregue/reinicie a extensão na página chrome://extensions/.
• Verifique os logs do servidor proxy para erros ou problemas.
• Certifique-se de que seu firewall ou software antivírus não esteja bloqueando a conexão.
• Certifique-se de que o servidor mostre o status de conexão adequado e exponha o endpoint /sse.

4. Formato incorreto de chamada de ferramenta

• Há momentos em que o modelo não gera o formato correto de chamada de ferramenta conforme solicitado, o que faz com que a detecção de ferramentas falhe. Nesses casos, use modelos melhores que sejam destinados à chamada de ferramentas ou que tenham melhores capacidades de chamada de ferramentas.
• Use o prompt de instruções personalizado, que pode ser encontrado na barra lateral do MCP SuperAssistant.
• Peça explicitamente para usar as ferramentas mencionando-as no prompt.
• Abaixo está um exemplo do formato correto de chamada de função MCP, que é renderizado pela extensão MCP SuperAssistant:

```jsonl
{"type": "function_call_start", "name": "function_name", "call_id": 1}
{"type": "description", "text": "Short 1 line of what this function does"}
{"type": "parameter", "key": "parameter_1", "value": "value_1"}
{"type": "parameter", "key": "parameter_2", "value": "value_2"}
{"type": "function_call_end", "call_id": 1}

### Manual Installation (Development)

#### Release Version
1. Download the latest release from [Releases](https://github.com/srbhptl39/MCP-SuperAssistant/releases)
2. Unzip the downloaded file
3. Navigate to `chrome://extensions/` in Chrome
4. Enable "Developer mode"
5. Click "Load unpacked" and select the unzipped directory
6. Follow [Connecting to Local Proxy Server](#connecting-to-local-proxy-server) to connect to your MCP server

## Development

### Prerequisites

- Node.js (v16+)
- pnpm

### Setup

```bash
# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

# Create zip package for distribution
pnpm zip

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

1. Faça um fork do repositório
2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
4. Envie para a branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Autor

Saurabh Patel

Patrocinador e Suporte

Este projeto é desenvolvido inteiramente no meu tempo livre, movido pela paixão por IA e pelo Model Context Protocol (MCP). Como profissional em tempo integral, equilibrar compromissos de trabalho com desenvolvimento de código aberto torna desafiador contribuir regularmente e manter o ritmo de atualizações.

Seu apoio me ajuda a dedicar mais tempo a:

• 🐛 Corrigir bugs e resolver problemas
• ✨ Adicionar novos recursos e suporte a plataformas
• 📚 Melhorar documentação e tutoriais
• 🔄 Manter dependências atualizadas
• 💬 Responder a solicitações da comunidade

Apoie este projeto:

• ⭐ Dê uma estrela no repositório para mostrar seu apreço
• 💖 Patrocine no GitHub para ajudar a sustentar o desenvolvimento
• 🐦 Siga-me no Twitter (@srbhptl39) para atualizações
• 📧 Para suporte privado ou implementações personalizadas, entre em contato pelo Twitter

Cada contribuição, grande ou pequena, ajuda a manter este projeto vivo e próspero! 🙏

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

• Inspirado pelo Model Context Protocol (MCP) da Anthropic
• Agradecimentos ao Cline pela inspiração da ideia
• Construído com Chrome Extension Boilerplate with React + Vite

Histórico de Estrelas