agentic-store-mcp

🔒 Por Que Você Precisa Disso: Segurança de IA de Nível Empresarial Encontra Agentes Autônomos

Dar a assistentes de IA como Claude, Cursor e Windsurf acesso ao seu código e à web é um superpoder. Mas enviar dados empresariais sensíveis para LLMs remotos é um risco de segurança enorme. Além disso, atingir rapidamente os limites de tokens degrada as janelas de contexto dos LLMs e aumenta os custos.

O Problema: Você quer o enorme ganho de produtividade dos fluxos de trabalho agênticos, mas não pode comprometer a Prevenção de Perda de Dados (DLP), a conformidade, a prevenção de vazamentos ou o inchaço de tokens.

A Solução: O Servidor MCP AgenticStore resolve toda a equação nativamente:

• 🛡️ O Firewall de Prompts LLM: Um proxy local seguro que intercepta, examina e sanitiza seus prompts antes de saírem da sua máquina. Ele sinaliza segredos vazados, PII e chaves de API, usando modelos locais (como Ollama) para sanitizar dados e gerar trilhas de auditoria rigorosas para todo o uso de IA.
• 🧰 O Kit de Ferramentas MCP (31 Ferramentas): Um arsenal pronto para produção. Equipe sua IA instantaneamente com tudo, desde analisadores de código e scanners de vulnerabilidades CVE (varreduras CVE OSV), até podadores de contexto, otimizadores de tokens, memória semântica persistente e busca web SearXNG auto-hospedada.

Zero assinaturas. Zero dependência de fornecedor. Configure suas ferramentas MCP manualmente ou sem esforço através de uma bela GUI local.

🎥 Demonstração do Firewall de Prompts

Seu navegador não suporta a tag de vídeo. Assista ao vídeo de demonstração do Firewall de Prompts aqui.
(Se o vídeo acima não carregar, clique aqui para assistir à demonstração)

🎥 Assista à Demonstração da GUI em Ação (Ferramentas MCP)

Seu navegador não suporta a tag de vídeo. Assista ao vídeo de demonstração da GUI do MCP AgenticStore aqui.
(Se o vídeo acima não carregar, clique aqui para assistir à demonstração)

🏗️ Como Funciona

🔥 Por Que Escolher o MCP AgenticStore?

• 🛡️ Firewall de Prompts LLM: Intercepte, sanitize e realize a gravação de prompts de todos os dados que saem do seu sistema, garantindo uma segurança de IA robusta.
• 🔒 100% Privacidade em Primeiro Lugar: Tudo roda localmente. Gere trilhas de auditoria confiáveis para o uso de IA enquanto seu código e dados nunca saem da sua máquina sem auditoria.
• ✂️ Otimização de Tokens LLM: Reduza radicalmente seu consumo de tokens com compressão estrutural de código (token_optimizer) e corte de contexto baseado em relevância (context_pruner).
• 💸 Realmente Gratuito: Sem contas, sem paywalls, sem assinaturas.
• 🧠 Memória Persistente do Agente: Deixe sua IA lembrar fatos e contextos entre sessões sem interrupções.
• ⚡ Plug & Play: Instala instantaneamente via uvx ou pip. A configuração MCP suporta tanto fluxos de trabalho manuais em JSON quanto via GUI.

📋 Sumário

• 🛡️ Firewall de Prompts LLM e Sanitização
• 🧰 O Que Há Dentro do Kit de Ferramentas
• 🚀 Guia de Início Rápido (Forma Mais Rápida de Instalar)
  • V0: Python/uvx (Recomendado)
  • V1: A Partir do Código-Fonte no GitHub
  • V2: Webapp MCP Hub (UI)
• 🔌 Conecte ao Seu Cliente de IA
• 🗂 Diretório de Ferramentas — Todas as 31 Ferramentas
• 💻 Integração com Claude Code CLI
• 🔎 Habilitando a Busca na Web
• 🎛 Substituindo Configurações e Uso Avançado

🛡️ Firewall de Prompts LLM e Sanitização

O Firewall de Prompts dá a você controle total sobre quais dados em linguagem natural e código saem do seu computador ao usar assistentes de codificação de IA baseados em nuvem, entregando segurança de IA de nível empresarial.

[!NOTE] O recurso de Firewall está atualmente testado e estável no macOS. Suporte para Linux e Windows está chegando em breve!

Recursos Principais:

• Interceptação por Proxy: Configure um proxy local para monitorar todo o tráfego de LLM.
• Trilhas de Auditoria para Uso de IA: Gere automaticamente logs de gravação de prompts. Obtenha avisos claros em cada nível de prompt mostrando exatamente o que foi alterado ou redigido.
• Configuração com 1 Clique na UI: Instale o certificado -> inicie o proxy. A mágica começa imediatamente. (Nota: A configuração do Firewall só é disponibilizada na UI para garantir instalação e operação tranquilas).
• Integração com LLM Local (Opcional): Conecte sua instância local Ollama. Baixe modelos de código aberto para executar sanitização de prompts totalmente local, pré-voo, examinando seu código para torná-lo melhor e mais seguro antes de enviá-lo a uma API remota.
• Sanitização Baseada em Regras: Defina facilmente regras de regex ou gramática para bloquear PII, chaves AWS, strings de banco de dados ou lógica proprietária.

Para habilitar o firewall e começar a coletar trilhas de auditoria para uso de IA, inicie o Webapp GUI e navegue até a aba Firewall para instalar o certificado e iniciar o proxy. Para uma arquitetura técnica mais aprofundada, leia a Documentação do Firewall de Prompts do AgenticStore fornecida oficialmente ou visite o site principal em agenticstore.dev.

🧰 O Que Há Dentro do Kit de Ferramentas (31 Ferramentas MCP)

Equipe seu cliente de IA com estes módulos contendo 31 ferramentas MCP específicas, categorizadas estrategicamente para máxima produtividade:

• 🛡️ Somente Local: 22 ferramentas executadas de forma privada, sem dependências de API externas.
• ☁️ API Necessária: 7 ferramentas que se conectam estritamente a provedores remotos (como a API do GitHub ou conectores Web).
• 📝 Acesso de Escrita: 6 ferramentas capazes de modificar com segurança seus repositórios ou arquivos locais.
• 👓 Somente Leitura: 25 ferramentas limitadas puramente à ingestão de contexto, garantindo segurança por padrão.

🚀 Guia de Início Rápido (Forma Mais Rápida de Instalar)

Escolha a configuração que melhor se adapta ao seu fluxo de trabalho. O MCP suporta tanto configuração manual quanto gerenciamento baseado em GUI. Não sabe qual escolher? Comece com V0.

pip install agentic-store-mcp --upgrade

agentic-store-mcp

agentic-store-mcp --version

pip install git+https://github.com/agenticstore/agentic-store-mcp.git

agentic-store-mcp

# Ensure it is installed via pip
pip install agentic-store-mcp --upgrade

# Launch the web UI  automatically bundled with the core package
agentic-store-webapp 

🔌 Conecte ao Seu Cliente de IA

Como o MCP AgenticStore suporta tanto configuração manual quanto gerenciamento via GUI, você pode adicionar manualmente o trecho de configuração ao arquivo de configuração do seu cliente, se preferir. Lembre-se de reiniciar o cliente após salvar! Para um guia aprofundado sobre como vincular agentes de IA corretamente, visite a Documentação de Conexão de Clientes em agenticstore.dev.

Configuração Padrão de Copiar-Colar

Configuração Básica:

{
  "mcpServers": {
    "agentic-store-mcp": {
      "command": "agentic-store-mcp",
      "args": []
    }
  }
}

Com Busca na Web (SearXNG) habilitada:

{
  "mcpServers": {
    "agentic-store-mcp": {
      "command": "agentic-store-mcp",
      "args": [],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

🗂 Diretório de Ferramentas — Todas as 31 Ferramentas

💻 Integração com Claude Code CLI

O AgenticStore MCP é totalmente compatível com Claude Code explicitamente para fluxos de trabalho em terminal, permitindo que desenvolvedores tenham acesso total às 31 capacidades de comando interagindo diretamente via linha de comando.

Modos de Execução Seguros via CLI

Instala automaticamente o aplicativo diretamente no seu ~/.claude/settings.json, resolvendo perfeitamente os vínculos de conexão. A CLI lida tanto com a operação tradicional quanto com a verificação de proxy interceptador de última geração de forma limpa, via uma estrutura de comandos CLI dinâmica.

Modo Padrão: (Para chamadas diretas à API — conecta-se a modelos Anthropic normais sem rastreamento de firewall):

agentic-store-mcp --install-claude

• Registra-se explicitamente no ~/.claude/settings.json do usuário localmente.
• Força ativamente a limpeza de launchctl unsetenv, descartando quaisquer vínculos de roteamento ANTHROPIC_BASE_URL obsoletos para garantir 100% de conexão estável diretamente às APIs padrão da Anthropic.
• Remove dinamicamente vestígios de forçamento de proxy do ambiente do seu sistema alvo ~/.zshrc/~/.bash_profile — novos terminais sempre iniciam completamente limpos.

Modo Firewall: (Pré-valida a estabilidade do proxy mapeando o tráfego de forma eficiente diretamente para os limites de segurança de Recodificação de Prompt, protegendo segredos empresariais):

agentic-store-mcp --install-claude --firewall-mode

• Primeiro verifica nativamente se o proxy de firewall do AgenticStore está escutando corretamente na Porta 8766 antes de tocar nas árvores de configuração, prevenindo completamente quebras de implantação.
• Injeta formalmente instruções de roteamento launchctl setenv, escrevendo adequadamente blocos de perfil de shell protegidos por nc na interceptação TLS ANTHROPIC_BASE_URL do Node.js diretamente no Claude.

(Nota: --firewall-mode recusa-se explicitamente a executar desacompanhado. Ele requer --install-claude passado ativamente junto).

Configuração Manual

Execute claude mcp add agentic-store-mcp "agentic-store-mcp".

🔎 Habilitando Pesquisa na Web

Para dar acesso à internet ao seu agente, agentic_web_search usa uma instância privada do SearXNG.

Se você quiser usar uma API remota ou hospedar seu próprio contêiner, basta anexar a URL dele.

Passe a variável de ambiente para seu Cliente de IA:

{
  "mcpServers": {
    "agentic-store-mcp": {
      "command": "agentic-store-mcp",
      "args": [],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

🎛 Substituindo Configurações e Uso Avançado

Substituir configurações está relacionado à sua configuração MCP. O MCP suporta configuração manual e via GUI, então você pode filtrar exatamente quais ferramentas são carregadas via variáveis de ambiente se estiver integrando profundamente sem a GUI web.

# Debug: List what would be loaded and exit
agentic-store-mcp --list

Nota: O Firewall de Prompt LLM é configurado exclusivamente via UI. O firewall só é disponibilizado na UI para garantir configuração suave, interceptação de proxy robusta e gravação de prompt sem interrupções pronta para uso.

🛠️ Solução de Problemas

Interrupção de Internet Após Uso de Proxy Ao lidar com o proxy do LLM Prompt Firewall, se o servidor for encerrado abruptamente, pode haver uma interrupção de internet na sua máquina devido a configurações residuais de proxy do sistema.

Se você perder a conexão com a internet após uma falha, execute este comando no seu terminal para restaurar o proxy ao padrão:

networksetup -setsecurewebproxystate "Wi-Fi" off

🤝 Contribuindo e Comunidade

Contribuições são o que tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Quaisquer contribuições que você fizer são muito apreciadas.

Se você quiser contribuir com código ou melhorias, por favor, faça um fork do repositório e crie um Pull Request.

⭐ Se este kit de ferramentas economizou 10 horas de configuração para você, por favor, dê-nos uma estrela para ajudar outros a encontrá-lo!

📜 Licença e Suporte

Este projeto é licenciado sob a Licença MIT — livre para usar, modificar e distribuir. Veja LICENÇA para detalhes.