Claude Dev Server
A Model Context Protocol (MCP) server that enables Claude to assist in software development by providing direct file system access within a specified workspace.
Features
- 🔍 Read file contents
- ✍️ Write and modify files
- 📁 Create directories
- 📋 List files and directories
- ℹ️ Get file information
- 🛠️ Implement code artifacts directly from Claude
Installation
- Make sure you have Python 3.10 or higher installed
- Create a new project directory:
- Set up a virtual environment using UV:
- Install the package in editable mode:
Project Structure
Configuration
To use the server with Claude Desktop, add it to your Claude Desktop configuration file:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Add this configuration:
Replace:
PATH_TO_YOUR_PROJECT
with the absolute path to your mcp-claude-dev directoryPATH_TO_YOUR_WORKSPACE
with the absolute path to the directory where Claude should have file access
Usage
- Start Claude Desktop
- The server will appear in the tools menu (hammer icon)
- You can now ask Claude to:
- Read files: "Can you read the contents of file.txt?"
- Write files: "Create a new file called example.py with a basic Flask app"
- List directories: "What files are in the current directory?"
- Create directories: "Create a new directory called 'src'"
- Get file info: "What's the size and modification date of main.py?"
- Implement code: "Write a Python function to calculate Fibonacci numbers and save it in math_utils.py"
Security Notes
- The server only allows access to files within the specified workspace directory
- All file operations require explicit paths relative to the workspace
- Directory traversal attempts outside the workspace are blocked
- File watching is implemented for change detection
Development
To contribute to the project:
- Clone the repository
- Install development dependencies
- Make your changes
- Test thoroughly before submitting a pull request
Running Tests
Available Tools
The server exposes these MCP tools:
read_file(path: str) -> str
: Read file contentswrite_file(path: str, content: str) -> str
: Write content to filelist_files(path: str = "") -> str
: List directory contentscreate_directory(path: str) -> str
: Create new directoryget_file_info(path: str) -> str
: Get file metadataimplement_artifact(path: str, content: str) -> str
: Save code artifacts
Error Handling
The server includes robust error handling for:
- Invalid paths
- Access attempts outside workspace
- File operation failures
- Permission issues
License
MIT License - feel free to use and modify as needed.
Contributing
Contributions are welcome! Please read our contributing guidelines and submit pull requests for any improvements.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
El servidor Claude Dev permite la interacción directa con el sistema de archivos dentro de un espacio de trabajo específico, lo que permite a los usuarios realizar operaciones de archivos y directorios e implementar artefactos de código en el desarrollo de software utilizando comandos de lenguaje natural.
- Características
- Instalación
- Estructura del proyecto
- Configuración
- Uso
- Notas de seguridad
- Desarrollo
- Herramientas disponibles
- Manejo de errores
- Licencia
- Contribuyendo
Related Resources
Related MCP Servers
- -securityFlicense-qualityThis server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.Last updated -4
- -securityFlicense-qualityA filesystem Model Context Protocol server that provides Claude Desktop with capabilities to read, write, and manipulate files on your system.Last updated -4
- AsecurityAlicenseAqualityAn MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.Last updated -15248MIT License
- AsecurityAlicenseAqualityEnables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.Last updated -610MIT License