MCP Workspace Server

Un servidor MCP ligero en Python que proporciona a los agentes de IA un acceso seguro y estructurado a los archivos dentro de un espacio de trabajo local controlado.

Descripción general

Los agentes de IA a menudo necesitan acceso al contexto del proyecto almacenado en archivos locales. Otorgar a un agente acceso sin restricciones al sistema de archivos introduce un riesgo de seguridad innecesario.

Este proyecto utiliza el Model Context Protocol (MCP) para exponer un pequeño conjunto de herramientas controladas del espacio de trabajo mientras restringe el acceso a un directorio configurado.

Related MCP server: Files MCP Server

Herramientas MCP

El servidor expone tres herramientas:

list_workspace_files

Lista los archivos disponibles dentro del espacio de trabajo configurado.

read_text_file

Lee archivos de texto UTF-8 con límites de tamaño configurables.

search_text

Busca archivos del espacio de trabajo y devuelve los nombres de archivo, números de línea y texto coincidentes.

Seguridad

El servidor resuelve las rutas solicitadas contra una raíz definida del espacio de trabajo y evita el path traversal fuera de ese directorio raíz.

Las salvaguardas adicionales incluyen:

• Acceso restringido al espacio de trabajo

• Validación de entradas

• Límites de tamaño de archivo

• Manejo de UTF-8

• Protección contra path traversal

• Pruebas de seguridad automatizadas

Estructura del Proyecto

mcp-workspace-server/
├── src/
│   └── mcp_workspace_server/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_paths.py
├── workspace/
│   └── example.txt
├── pyproject.toml
└── README.md