agentic-store-mcp
Potencia tus agentes de IA con 31 herramientas listas para producción. Incluye análisis local de Python en primer lugar, búsqueda en tiempo real con SearXNG y un proxy local seguro para sanitizar indicaciones. Diseñado para desarrolladores que valoran el rendimiento y la privacidad. Instala una vez, usa en todas partes.
Documentación
⚡ Servidor MCP AgenticStore: Firewall de Prompts para LLM, Optimización de Tokens y Kit de Seguridad para IA
Servidor de Protocolo de Contexto de Modelo (MCP) de Código Abierto para Privacidad de Datos, Registro de Prompts, Registros de Auditoría y 31 Herramientas de Agente para Claude Code, Cursor y Windsurf.
📖 Documentación Oficial • 🚀 Inicio Rápido • 🛡️ Firewall de Prompts • 🗂️ Directorio Completo de Herramientas • 🌐 Búsqueda Web • 🔌 Configuración del Cliente • 💻 Claude Code • 🖥️ Aplicación Web GUI
🔒 Por Qué Lo Necesitas: Seguridad de IA de Nivel Empresarial Combinada con Agentes Autónomos
Dar a asistentes de IA como Claude, Cursor y Windsurf acceso a tu código y a la web es un superpoder. Pero pasar datos empresariales sensibles a LLMs remotos es un riesgo de seguridad masivo. Además, alcanzar rápidamente los límites de tokens degrada las ventanas de contexto de los LLM y aumenta los costos.
El Problema: Quieres el enorme aumento de productividad de los flujos de trabajo agénticos, pero no puedes comprometer la Prevención de Pérdida de Datos (DLP), el cumplimiento normativo, la prevención de fugas ni la inflación de tokens.
La Solución: El Servidor MCP AgenticStore resuelve toda la ecuación de forma nativa:
- 🛡️ El Firewall de Prompts para LLM: Un proxy local seguro que intercepta, escanea y sanitiza tus prompts antes de que salgan de tu máquina. Detecta secretos filtrados, PII y claves API, utilizando modelos locales (como Ollama) para sanitizar datos y generar rastros de auditoría estrictos para todo uso de IA.
- 🧰 El Kit de Herramientas MCP (31 Herramientas): Un arsenal listo para producción. Equipa instantáneamente a tu IA con todo, desde analizadores de código y escáneres de vulnerabilidades CVE (escaneos CVE de OSV), hasta podadores de contexto, optimizadores de tokens, memoria semántica persistente y búsqueda web SearXNG autoalojada.
Cero suscripciones. Cero dependencia de proveedor. Configura tus herramientas MCP manualmente o sin esfuerzo a través de una hermosa GUI local.
🎥 Demostración del Firewall de Prompts
Tu navegador no soporta la etiqueta de video. Mira el video de demostración del Firewall de Prompts aquí.(Si el video de arriba no carga, haz clic aquí para ver la demostración)
🎥 Mira la Demostración de la GUI en Acción (Herramientas MCP)
Tu navegador no soporta la etiqueta de video. Mira el video de demostración de la GUI del Servidor MCP AgenticStore aquí.
(Si el video de arriba no carga, haz clic aquí para ver la demostración)
🏗️ Cómo Funciona
🔥 ¿Por Qué Elegir el Servidor MCP AgenticStore?
| Característica | Servidor MCP AgenticStore | Servidores MCP Estándar |
|---|---|---|
| Seguridad de IA y Firewall de Prompts | 🛡️ Sí (Proxy y DLP basado en reglas) | ❌ No |
| Rastros de Auditoría y Registros | 📝 Sí (Registro de prompts y cumplimiento) | ❌ No |
| Sanitización de Prompts con LLM Local | 🦙 Sí (Integración con Ollama) | ❌ No |
| Memoria de Agente Persistente | 🧠 Sí (sobrevive reinicios y sesiones) | ❌ No |
| Optimización y Poda de Tokens | ✂️ Sí (Compresión de tokens LLM) | ❌ No |
| Búsqueda Web Agéntica | 🌐 SearXNG autoalojado | ❌ Generalmente No |
| Capacidades | 🛠️ 31 herramientas especializadas | ⛏️ 1 a 5 herramientas básicas |
| Configuración | 🖥️ Panel Web GUI O ⚙️ Manual | ⚙️ Configuración JSON manual |
| Privacidad | 🔒 100% Ejecución Local | 🔒 Varía |
- 🛡️ Firewall de Prompts para LLM: Intercepta, sanitiza y realiza registro de prompts de todos los datos que salen de tu sistema, garantizando una sólida seguridad de IA.
- 🔒 100% Privacidad Primero: Todo se ejecuta localmente. Genera rastros de auditoría confiables para el uso de IA mientras tu código y datos nunca salen de tu máquina sin auditoría.
- ✂️ Optimización de Tokens LLM: Reduce radicalmente tu consumo de tokens con compresión estructural de código (
token_optimizer) y recorte de contexto basado en relevancia (context_pruner). - 💸 Realmente Gratis: Sin cuentas, sin muros de pago, sin suscripciones.
- 🧠 Memoria de Agente Persistente: Permite que tu IA recuerde hechos y contextos entre sesiones sin problemas.
- ⚡ Plug & Play: Se instala instantáneamente vía
uvxopip. La configuración MCP admite tanto flujos de trabajo JSON manuales como GUI.
📋 Tabla de Contenidos
- 🛡️ Firewall de Prompts para LLM y Sanitización
- 🧰 Qué Hay Dentro del Kit de Herramientas
- 🚀 Guía de Inicio Rápido (Forma Más Rápida de Instalar)
- 🔌 Conéctate a Tu Cliente de IA
- 🗂 Directorio de Herramientas — Las 31 Herramientas
- 💻 Integración CLI de Claude Code
- 🔎 Habilitando la Búsqueda Web
- 🎛 Anulación de Configuraciones y Uso Avanzado
🛡️ Firewall de Prompts para LLM y Sanitización
El Firewall de Prompts te da control total sobre qué datos en lenguaje natural y código salen de tu computadora cuando usas asistentes de codificación de IA basados en la nube, brindando seguridad de IA de nivel empresarial.
[!NOTE] La función de Firewall actualmente está probada y es estable en macOS. ¡El soporte para Linux y Windows llegará pronto!
Características Clave:
- Intercepción por Proxy: Configura un proxy local para monitorear todo el tráfico de LLM.
- Rastros de Auditoría para el Uso de IA: Genera automáticamente registros de registro de prompts. Obtén advertencias claras en cada nivel de prompt mostrando exactamente qué se cambió o redactó.
- Configuración UI con 1 Clic: Instala certificado -> inicia proxy. La magia comienza inmediatamente. (Nota: La configuración del Firewall solo está disponible en la UI para garantizar una instalación y operación fluidas).
- Integración con LLM Local (Opcional): Conecta tu instancia local de Ollama. Descarga modelos de código abierto para ejecutar sanitización de prompts completamente local previa al envío, escaneando tu código para mejorarlo y hacerlo más seguro antes de enviarlo a una API remota.
- Sanitización Basada en Reglas: Define fácilmente reglas regex o gramaticales para bloquear PII, claves AWS, cadenas de base de datos o lógica propietaria.
Para habilitar el firewall y comenzar a recopilar rastros de auditoría para el uso de IA, inicia la Aplicación Web GUI y navega a la pestaña Firewall para instalar el certificado e iniciar el proxy. Para una arquitectura técnica más profunda, lee la Documentación del Firewall de Prompts de AgenticStore proporcionada oficialmente o visita el sitio principal en agenticstore.dev.
🧰 Qué Hay Dentro del Kit de Herramientas (31 Herramientas MCP)
Equipa a tu cliente de IA con estos módulos que contienen 31 herramientas MCP específicas, categorizadas estratégicamente para máxima productividad:
- 🛡️ Solo Local: 22 herramientas que se ejecutan de forma privada sin dependencias de API externas.
- ☁️ API Requerida: 7 herramientas que se conectan estrictamente a proveedores remotos (como la API de GitHub o conectores web).
- 📝 Acceso de Escritura: 6 herramientas capaces de modificar de forma segura tus repositorios o archivos locales.
- 👓 Solo Lectura: 25 herramientas limitadas puramente a la ingesta de contexto, garantizando seguridad por defecto.
| Módulo | Propósito | Capacidades Clave | Herramientas |
|---|---|---|---|
| 💻 Código (Codebase, GitHub, Seguridad) | Dominio y seguridad del codebase | Análisis estático, PRs de GitHub, escaneos CVE de OSV, escaneo CodeQL | 8 |
| 🌐 Datos (Búsqueda y Rastreo) | Acceso a Internet para Agentes | Búsqueda web privada (SearXNG) y rastreo web profundo | 2 |
| 🧠 Memoria (Productividad y Almacenamiento) | Manipulación y persistencia de contexto | Guardar/leer hechos, optimizar tokens LLM, poda de contexto | 16 |
| 🛠️ Herramientas y Configuración del Sistema | Configuración y monitoreo del SO | Verificar procesos del host en ejecución, ver registros del sistema, descubrimiento | 5 |
🚀 Guía de Inicio Rápido (Forma Más Rápida de Instalar)
Elige la configuración que mejor se adapte a tu flujo de trabajo. MCP admite tanto configuración manual como gestión basada en GUI. ¿No sabes cuál elegir? Comienza con V0.
V0 — Python / uvx (Inicio más rápido, sin necesidad de Docker)
1️⃣ Instala vía PyPI
pip install agentic-store-mcp --upgrade
(O usa uvx agentic-store-mcp si tienes el conjunto de herramientas de Astral).
2️⃣ Ejecuta el servidor MCP
agentic-store-mcp
3️⃣ (Opcional) Verifica tu instalación
agentic-store-mcp --version
4️⃣ Configura tu Cliente de IA
Consulta la sección Conéctate a Tu Cliente de IA para vincularlo manualmente, ¡o usa la UI!
💡 Pro-Tip (Búsqueda Web): ¿Quieres búsqueda web? Consulta nuestra Configuración de Copiar y Pegar a continuación. Ver Configuración de Búsqueda Web.
V1 — Desde el Código Fuente de GitHub (Últimas Funciones)
1️⃣ Instala directamente desde el repositorio
pip install git+https://github.com/agenticstore/agentic-store-mcp.git
(O usando uv: uvx --from git+https://github.com/agenticstore/agentic-store-mcp.git agentic-store-mcp)
2️⃣ Ejecuta el servidor MCP
agentic-store-mcp
3️⃣ Configura tu Cliente de IA
¡Consulta la sección Conéctate a Tu Cliente de IA para vincularlo!
V2 — UI del MCP Hub (Gestiona todo visualmente)
¡Olvídate de la edición manual de JSON! Usa nuestra UI web local para:
- 🛡️ Firewall: Configura certificados y monitorea todos los prompts LLM interceptados y registros de auditoría para un registro de prompts completo.
- 🔑 Conectores: Ingresa claves API remotas de forma segura (almacenadas en el llavero del SO).
- 🛠️ Herramientas: Alterna cuáles de las 31 herramientas exponer a la IA.
- 💻 Clientes: Genera automáticamente configuración para Claude, Cursor y Windsurf.
- 🧠 Memoria: Gestiona estados de agente persistentes, puntos de control, optimización de tokens y registros.
Inicia el Hub vía Python:
# 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
Accede a él en: http://localhost:8765
🔌 Conéctate a Tu Cliente de IA
Debido a que el Servidor MCP AgenticStore admite tanto configuración manual como gestión vía GUI, puedes agregar manualmente el fragmento de configuración al archivo de configuración de tu cliente respectivo si lo prefieres. ¡Recuerda reiniciar el cliente después de guardar! Para una guía detallada sobre cómo vincular agentes de IA correctamente, visita la Documentación de Conexión de Clientes en agenticstore.dev.
| Cliente | Ruta del Archivo de Configuración |
|---|---|
| Claude Desktop (Mac) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Win) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | Se agrega a tu settings.json de VS Code bajo la configuración de la extensión MCP |
Configuración Estándar de Copiar y Pegar
Configuración Básica:
{
"mcpServers": {
"agentic-store-mcp": {
"command": "agentic-store-mcp",
"args": []
}
}
}
Con Búsqueda Web (SearXNG) habilitada:
{
"mcpServers": {
"agentic-store-mcp": {
"command": "agentic-store-mcp",
"args": [],
"env": {
"SEARXNG_URL": "http://localhost:8080"
}
}
}
}
🗂 Directorio de Herramientas — Las 31 Herramientas
📝 Módulo de Código (8 herramientas)
Análisis de Codebase
Analiza, busca y navega por tu codebase sin problemas.
| Herramienta | Capacidad |
|---|---|
analyze_commits | Analiza el contexto del historial de commits de git (autores, frecuencia, patrones). |
get_file | Obtiene y lee el contenido de sintaxis de archivos directamente desde repositorios de GitHub. |
python_lint_checker | Ejecuta análisis estático en archivos Python (encuentra errores, importaciones no utilizadas, estilo estructural). |
search_code | Búsqueda ultrarrápida de patrones de código de texto completo en archivos locales y GitHub. |
Integración remota
(Requiere un token de acceso personal de GitHub. Configúralo mediante GITHUB_TOKEN o MCP Hub).
| Herramienta | Capacidad |
|---|---|
create_pr | Abre automáticamente nuevas Pull Requests internas en GitHub. |
get_repo_info | Obtén metadatos del repositorio de GitHub (stars, forks, contribuyentes). |
manage_issue | Crea, actualiza, comenta y cierra issues de GitHub. |
Seguridad y auditoría
Verificación de DevSecOps y cadena de suministro impulsada por agentes.
| Herramienta | Capacidad |
|---|---|
code_scanning_alerts | Recupera hallazgos de seguridad de CodeQL y Semgrep desde GitHub. |
dependabot_alerts | Obtén alertas automatizadas de vulnerabilidades de dependencias mediante la integración con Dependabot. |
dependency_audit | Escanea paquetes (requirements.txt, package.json, go.mod) dinámicamente contra la base de datos OSV CVE. |
repo_scanner | Escanea secretos filtrados (claves API), fugas de PII y aplica el cumplimiento de .gitignore. |
🌐 Módulo de datos (2 herramientas)
| Herramienta | Capacidad |
|---|---|
agentic_web_crawl | Extrae texto markdown limpio, encabezados y señales de metadatos SEO de cualquier URL. |
agentic_web_search | Realiza búsquedas semánticas en vivo de forma segura mediante SearXNG autoalojado. |
🧠 Módulo de memoria (16 herramientas)
La memoria persistente y la reducción de tokens garantizan que los agentes LLM puedan transferir trabajo a través de repositorios masivos en sesiones de chat extensas de forma segura.
Productividad y optimización de tokens
| Herramienta | Capacidad |
|---|---|
token_optimizer | NUEVO: Comprime radicalmente código/texto antes de enviarlo al LLM. Admite tres modos (comprimir, resumir, ambos) en varios lenguajes (Python, JS/TS, Go, Rust, Java, C/C++, Shell) eliminando cadenas no funcionales y mostrando esquemas estructurales. Devuelve automáticamente métricas de tokens ahorrados. |
context_pruner | NUEVO: Recomienda exactamente qué archivos/datos descartar para reducir ventanas de tokens masivas, puntuando cada elemento por superposición de palabras clave con la descripción de tu tarea activa. Nunca desperdicia sobrecarga de contexto de red. |
restore_session | Carga todo el contexto histórico de tu espacio de trabajo desde un punto de control. |
spinup_memory | Inicializa un directorio de memoria de proyecto nuevo de forma elegante. |
update_change_log | Añade notas de versión semánticas estructuradas a CHANGELOG.md. |
update_learnings | Registra descubrimientos técnicos en un repositorio markdown perpetuo y buscable. |
update_milestones | Realiza un seguimiento preciso del progreso de hitos sin problemas a medida que el desarrollo escala. |
update_plan | Edita, añade o revisa tu plan.md arquitectónico central. |
Primitivas de almacenamiento
| Herramienta | Capacidad |
|---|---|
memory_checkpoint | Guarda una instantánea completa de estados conversacionales, decisiones y planes inmediatos. |
memory_log | Añade registros de marcas de tiempo en tiempo real de la actividad de la sesión. |
memory_read | Obtén hechos estructurados de manera eficiente. |
memory_restore | Lee y restaura configuraciones de estado desde puntos de control almacenados. |
memory_search | Búsqueda contextual de texto completo indexando bases de datos de memoria perfectamente. |
memory_write | Confirma hechos JSON persistentes que sobreviven directamente a las ventanas de chat estándar de LLM. |
🛠️ Módulo de herramientas (5 herramientas)
| Herramienta | Capacidad |
|---|---|
configure | Anula dinámicamente configuraciones de ejecución y conectores de API por completo. |
list_processes | NUEVO: Consulta al instante si sistemas de software específicos se están ejecutando correctamente dentro de los límites de pgrep y lsof en 11 endpoints conocidos integrados (por ejemplo, Docker, Redis, Postgres, MongoDB, Node, Celery). Devuelve PIDs correctamente de forma nativa. |
tail_system_logs | NUEVO: Algoritmo inteligente y eficiente de seguimiento de archivos de registro (búsqueda desde el final). Nunca colapsa las ventanas de contexto en archivos de registro de gigabytes; lee el contexto mínimo necesario filtrando directamente por criterios como 'error' y 'excepción' limitando limpiamente el uso de memoria a 1000 líneas. |
tool_search | Recupera un directorio detallado de cada herramienta MCP activa disponible. |
💻 Integración con Claude Code CLI
AgenticStore MCP es totalmente compatible con Claude Code específicamente para flujos de trabajo en terminal, permitiendo a los desarrolladores acceso completo a las 31 capacidades de comando interactuando directamente mediante la línea de comandos.
Modos seguros de ejecución CLI
Instala automáticamente la aplicación directamente en tu ~/.claude/settings.json resolviendo sin problemas los enlaces de conexión. El CLI maneja tanto la operación tradicional como la verificación de proxy interceptador de última generación de manera limpia mediante una estructura de comandos CLI dinámica.
Modo predeterminado: (Para llamadas directas a la API — se conecta a modelos Anthropic normales sin seguimiento de firewall):
agentic-store-mcp --install-claude
- Se registra explícitamente en el
~/.claude/settings.jsondel usuario localmente. - Fuerza activamente la limpieza de
launchctl unsetenveliminando cualquier enlace de enrutamiento obsoleto deANTHROPIC_BASE_URLpara asegurar una conexión 100% estable directamente a las APIs estándar de Anthropic. - Elimina dinámicamente rastros de forzado de proxy de tu entorno de sistema objetivo
~/.zshrc/~/.bash_profile— las nuevas terminales siempre comienzan completamente limpias.
Modo firewall: (Prevalida la estabilidad del proxy mapeando el tráfico de manera eficiente directamente en los límites de seguridad de Recodificación de Prompts protegiendo secretos empresariales):
agentic-store-mcp --install-claude --firewall-mode
- Primero verifica de forma nativa que el proxy de firewall de AgenticStore esté escuchando correctamente en el puerto 8766 antes de tocar los árboles de configuración, evitando por completo fallos de implementación.
- Inyecta formalmente instrucciones de enrutamiento
launchctl setenvescribiendo correctamente bloques de perfil de shell protegidos por nc en la intercepción TLS de Node.jsANTHROPIC_BASE_URLdirectamente en Claude.
(Nota: --firewall-mode se niega explícitamente a ejecutarse sin compañía. Requiere que --install-claude se pase activamente junto a él).
Configuración manual
Ejecuta claude mcp add agentic-store-mcp "agentic-store-mcp".
🔎 Habilitar búsqueda web
Para darle acceso a internet a tu agente, agentic_web_search utiliza una instancia privada de SearXNG.
Si deseas usar una API remota o alojar tu propio contenedor, simplemente añade su URL.
Pasa la variable de entorno a tu cliente de IA:
{
"mcpServers": {
"agentic-store-mcp": {
"command": "agentic-store-mcp",
"args": [],
"env": {
"SEARXNG_URL": "http://localhost:8080"
}
}
}
}
🎛 Anulación de configuraciones y uso avanzado
La anulación de configuraciones está relacionada con tu configuración de MCP. MCP admite tanto configuración manual como GUI, por lo que puedes filtrar exactamente qué herramientas se cargan mediante variables de entorno si te integras profundamente sin la GUI web.
# Debug: List what would be loaded and exit
agentic-store-mcp --list
Nota: El Firewall de Prompts de LLM se configura exclusivamente a través de la UI. El firewall solo está disponible en la UI para garantizar una configuración fluida, una interceptación de proxy robusta y un registro de prompts sin problemas desde el primer momento.
🛠️ Solución de problemas
Interrupción de internet después del uso del proxy Al tratar con el proxy del Firewall de Prompts de LLM, si el servidor se termina abruptamente, podría haber una interrupción de internet en tu máquina debido a configuraciones residuales del proxy del sistema.
Si pierdes la conexión a internet después de un fallo, ejecuta este comando en tu terminal para restaurar tu proxy a los valores predeterminados:
networksetup -setsecurewebproxystate "Wi-Fi" off
🤝 Contribuciones y comunidad
Las contribuciones son lo que hace que la comunidad de código abierto sea un lugar tan increíble para aprender, inspirar y crear. Cualquier contribución que hagas es muy apreciada.
Si deseas contribuir con código o mejoras, por favor haz un fork del repositorio y crea una Pull Request.
⭐ Si este kit de herramientas te ahorró 10 horas de configuración, ¡por favor danos una estrella para ayudar a otros a encontrarlo!
📜 Licencia y soporte
Este proyecto está licenciado bajo la Licencia MIT — libre de usar, modificar y distribuir. Consulta LICENSE para más detalles.
⭐ Gestiona todo más fácilmente a través de la Webapp: agentic-store-webapp
Construido con ❤️ por AgenticStore.dev — Herramientas de IA de código abierto para todos.
🏷️ Tecnologías principales y ecosistema
AgenticStore está construido para el ecosistema del Protocolo de Contexto de Modelo (MCP Server) para proporcionar una Seguridad LLM robusta, un Firewall de Prompts y una Privacidad de Datos de IA proactiva. Admite una Prevención de Pérdida de Datos (DLP) integral mediante Sanitización de Prompts, Registro de Prompts y Rastros de Auditoría para el Uso de IA. Diseñado para Agentes Autónomos y Asistentes de Codificación de IA como Integración MCP de Claude Code, Cursor IDE MCP y Windsurf.
Abordamos los problemas de escalado más difíciles para los LLM modernos de forma nativa mediante Compresión de Tokens LLM, descarga de ventanas de contexto de forma nativa mediante Poda de Contexto, procesamiento estructurado de código mediante Optimización de Tokens y Memoria Persistente de Agente profunda. Combinando una supervisión sistémica profunda que abarca DevSecOps de IA, Escaneos de Dependencias OSV CVE, Análisis Estático de Código, Gestión de Procesos del SO local (mediante list_processes), Seguimiento de Archivos de Registro dinámico en streaming y Búsqueda Web de Agente privada mediante SearXNG. Escala localmente ejecutando de manera confiable con Integración de Ollama para Requisitos de Auditoría de IA inquebrantables.