Servidor MCP

Un servidor de Model Context Protocol (MCP) modular construido con FastAPI, que proporciona herramientas para interacciones con LLM.

Características

• Arquitectura modular - Cada herramienta es fácilmente mantenible

• Operaciones de archivos - Leer, escribir, añadir, reemplazar e insertar texto en archivos

• Búsqueda web - Buscar en la web en tiempo real usando DDGS

• Obtención de URL - Scraping y resumen de contenido web

• Ejecución de comandos - Ejecutar comandos de shell en un entorno sandbox

• Aislamiento estricto - Sandbox Bubblewrap con /tmp desechable

Related MCP server: mcp-toolkit

Herramientas

Instalación

# Clone the repository
git clone <repository-url>
cd mcp_server

# Install dependencies using uv
uv sync

Uso

# Start the server
python main.py

El servidor se iniciará en http://0.0.0.0:8000.

Arquitectura

mcp_server/
├── main.py              # FastAPI application entry point
├── tools.json           # Tool definitions (JSON schema)
└── tools/               # Tool implementations
    ├── __init__.py      # Exports all handlers
    ├── add.py           # Math operations
    ├── today.py         # Date/time
    ├── web_search.py    # Web search
    ├── fetch_content.py # URL scraping
    ├── files.py         # All file operations
    └── run_command.py   # Shell command execution

Configuración del Sandbox

La herramienta run_command utiliza bubblewrap para el aislamiento:

• Sistema de archivos raíz de solo lectura (--ro-bind / /)

• Directorio temporal desechable (--tmpfs /tmp)

• Directorio de recursos escribible (--bind resources resources)

• Resolución DNS habilitada (sin restricción de /etc)

Descargo de responsabilidad

Este proyecto fue desarrollado con la asistencia de Qwen 3.6, un modelo de lenguaje grande de Tongyi Lab de Alibaba Group. Aunque la IA ayudó en la generación de código, documentación y refactorización, todas las decisiones técnicas y las implementaciones finales fueron revisadas y validadas por el desarrollador humano.

Licencia

Licencia MIT