mcp-agent-tools
Provides web search functionality via the Brave Search API, enabling agents to search the web.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Agent Tools
Caja de herramientas MCP que extiende a VS Code Copilot (con tu modelo Qwen3 vía API OpenAI) con capacidades que VS Code no trae nativamente.
🔧 Tools disponibles
Tool | Qué hace |
| Guarda un hecho en memoria semántica persistente. Devuelve un id opaco. |
| Busca en memoria por similitud semántica. |
| Elimina un recuerdo. |
| Indexa el código del workspace para búsqueda semántica. |
| Busca código por similitud semántica (RAG). |
| Ejecuta Python en sandbox. Devuelve stdout/stderr/exit/duration. |
| Ejecuta un comando shell en sandbox. |
| Trae una URL y extrae el texto. |
| Busca en la web (requiere TAVILY_API_KEY o BRAVE_API_KEY). |
| Razonamiento structured multi-paso. |
Related MCP server: VSC as MCP
🚀 Subir
# Crear .env con las variables opcionales
cp .env.example .env
# Build y subir
docker compose up -d --build
# Verificar
curl http://localhost:8000/healthPrimera vez: se descarga el modelo de embeddings (~80 MB) a db/models/.
🖥️ Conectar en VS Code
Opción A — .vscode/mcp.json (ya incluido en el repo):
Abre el workspace → VS Code detecta el server → diálogo de trust → Connect.
Opción B — Command Palette:
Ctrl+Shift+P→MCP: Add ServerSelecciona Workspace
Pega:
{ "type": "http", "url": "http://localhost:8000/mcp" }Nombre:
mcp-agent-tools
Opción C — .mcp.json portable (raíz del workspace):
{ "mcpServers": { "mcp-agent-tools": { "type": "http", "url": "http://localhost:8000/mcp" } } }Verificar: MCP: List Servers → mcp-agent-tools debe mostrar connected.
🖥️ UI web de gestión de tools
Abre: http://localhost:8000/admin/
Permite en runtime (sin reiniciar el contenedor):
Listar todas las tools (built-in + dinámicas)
Crear tools nuevas (Python o HTTP)
Editar / Borrar / Habilitar / Deshabilitar
Test de tools con args antes de guardar
Live update: VS Code se actualiza solo (
tools/list_changedde FastMCP)
Las tools creadas por UI se persisten en db/tools.json y se cargan automáticamente al arrancar.
📁 Estructura
mcp/
├── src/server.py # Punto de entrada — create_app() + run_http()
├── src/tools/ # Tools built-in (extensibilidad por código)
│ ├── memory.py # memoria semántica
│ ├── rag.py # RAG sobre código
│ ├── exec.py # run_python / run_shell
│ ├── web.py # web_fetch / web_search
│ └── thinking.py # sequential thinking
├── src/admin/ # UI web de gestión (FastAPI + vanilla JS)
│ ├── tool_store.py # persistencia en db/tools.json
│ ├── executor.py # sandbox executor (subprocess)
│ ├── api_tools.py # REST API
│ └── static/ # dashboard single-page
├── db/ # volumen: agent.db, code_index.db, tools.json
├── pyproject.toml
├── Dockerfile
├── docker-compose.yml
├── .vscode/mcp.json
└── README.md➕ Agregar una tool nueva
Por código (permanente, versionada):
Crea
src/tools/mi_tool.py:def setup(mcp): @mcp.tool(name="mi_tool", description="Qué hace mi tool") async def mi_tool(param: str) -> dict: return {"result": param}Agrega en
src/tools/__init__.py→TOOLS = [..., "src.tools.mi_tool"]Rebuild:
docker compose up -d --build
Por UI web (efímera, en runtime):
Abre
http://localhost:8000/admin/Click "Nueva tool"
Fill name, description, source_type (Python/HTTP), params, code
Test → Save
Aparece en VS Code inmediatamente (sin reconectar)
🌍 Variables de entorno
Variable | Default | Descripción |
|
| Ruta base para |
| (vacío) | Key para |
| (vacío) | Key alternativa para |
| (vacío) | Si se define, |
|
| Timeout por defecto para |
🔒 Seguridad
Sandbox:
run_pythony tools Python dinámicas se ejecutan en subprocess aisladoWhitelist de módulos (tools dinámicas):
httpx, json, re, math, datetime, os.path— sinsubprocess, socket, sys, shutil, sqlite3MCP_ADMIN_TOKEN: protege la UI admin en entornos no-localhostVolume
db/: la memoria es local; borrardb/agent.dbresetea la memoria
🧹 Resetear
# Resetear memoria semántica
rm db/agent.db
# Resetear índice de código
rm db/code_index.db
# Resetear tools dinámicas
rm db/tools.json
# Resetear todo
docker compose down -v
rm -rf db/🐛 Troubleshooting
VS Code no conecta: Verifica que
docker compose psmuestrerunning, que el puerto 8000 no esté ocupado (ss -tlnp | grep 8000)web_searchdevuelve error: ConfiguraTAVILY_API_KEYoBRAVE_API_KEYen.envcode_searchdevuelve vacío: Ejecutacode_index()primero desde el chat o MCP InspectorModelo de embeddings no descarga: Verifica internet en el contenedor;
HF_HOME=/app/db/modelsUI no se abre: Verifica
http://localhost:8000/admin/— debe servirindex.html
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Cross-tool persistent memory and context for AI assistants over MCP.
Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP Memory Agent Server - A VS Code chatmode and instruction manager with library integration929 PyPI10MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to leverage VS Code's language intelligence for code navigation, refactoring, and analysis via the MCP protocol.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to access VS Code's LSP-based code navigation and native debugging tools (definitions, references, outline, breakpoints, stepping, stack frames, variables, and evaluate) via the MCP protocol.MIT
- AlicenseBqualityBmaintenanceEnables AI coding agents and local LLMs to store and recall project memory, compact verbose logs, look up code symbols, create and rewind workspace snapshots, detect risky commands and loops, pack context optimally, and draft tokens through MCP tools.102Apache 2.0