Claude Dev Server

Servidor de desarrollo de Claude

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude ayudar en el desarrollo de software al proporcionar acceso directo al sistema de archivos dentro de un espacio de trabajo específico.

Características

• 🔍 Leer el contenido del archivo
• ✍️ Escribir y modificar archivos
• 📁 Crear directorios
• 📋 Listar archivos y directorios
• ℹ️ Obtener información del archivo
• 🛠️ Implementa artefactos de código directamente desde Claude

Instalación

1. Asegúrese de tener instalado Python 3.10 o superior
2. Crear un nuevo directorio de proyecto:

3. Configurar un entorno virtual usando UV:

4. Instalar el paquete en modo editable:

Estructura del proyecto

Configuración

Para utilizar el servidor con Claude Desktop, agréguelo a su archivo de configuración de Claude Desktop:

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Añade esta configuración:

Reemplazar:

• PATH_TO_YOUR_PROJECT con la ruta absoluta a su directorio mcp-claude-dev
• PATH_TO_YOUR_WORKSPACE con la ruta absoluta al directorio donde Claude debería tener acceso a los archivos

Uso

1. Iniciar Claude Desktop
2. El servidor aparecerá en el menú de herramientas (icono de martillo)
3. Ahora puedes pedirle a Claude que:
   • Leer archivos: "¿Puedes leer el contenido del archivo .txt?"
   • Escribir archivos: "Crear un nuevo archivo llamado example.py con una aplicación básica de Flask"
   • Listar directorios: "¿Qué archivos hay en el directorio actual?"
   • Crear directorios: "Crear un nuevo directorio llamado 'src'"
   • Obtener información del archivo: "¿Cuál es el tamaño y la fecha de modificación de main.py?"
   • Implementar código: "Escribir una función de Python para calcular los números de Fibonacci y guardarla en math_utils.py"

Notas de seguridad

• El servidor sólo permite el acceso a los archivos dentro del directorio del espacio de trabajo especificado
• Todas las operaciones de archivos requieren rutas explícitas relativas al espacio de trabajo
• Los intentos de atravesar directorios fuera del espacio de trabajo están bloqueados
• Se implementa la vigilancia de archivos para la detección de cambios

Desarrollo

Para contribuir al proyecto:

1. Clonar el repositorio
2. Instalar dependencias de desarrollo
3. Realiza tus cambios
4. Pruebe exhaustivamente antes de enviar una solicitud de extracción

Ejecución de pruebas

Herramientas disponibles

El servidor expone estas herramientas MCP:

• read_file(path: str) -> str : Leer el contenido del archivo
• write_file(path: str, content: str) -> str : Escribe el contenido en el archivo
• list_files(path: str = "") -> str : Lista el contenido del directorio
• create_directory(path: str) -> str : Crea un nuevo directorio
• get_file_info(path: str) -> str : Obtener metadatos del archivo
• implement_artifact(path: str, content: str) -> str : Guardar artefactos de código

Manejo de errores

El servidor incluye un manejo robusto de errores para:

• Rutas no válidas
• Intentos de acceso fuera del espacio de trabajo
• Fallos en la operación de archivos
• Problemas de permisos

Licencia

Licencia MIT: siéntete libre de usarla y modificarla según sea necesario.

Contribuyendo

¡Agradecemos sus contribuciones! Lea nuestras normas de contribución y envíe solicitudes de incorporación de cambios para cualquier mejora.