Claude Dev Server

一个模型上下文协议（MCP）服务器，通过提供指定工作空间内的直接文件系统访问，使Claude能够协助软件开发。

特性

• 🔍 读取文件内容
• ✍️ 写入和修改文件
• 📁 创建目录
• 📋 列出文件和目录
• ℹ️ 获取文件信息
• 🛠️ 直接从Claude实现代码工件

安装

1. 确保已安装Python 3.10或更高版本
2. 创建一个新的项目目录：

mkdir mcp-claude-dev
cd mcp-claude-dev

1. 使用UV设置虚拟环境：

uv venv

1. 以可编辑模式安装包：

uv pip install -e .

项目结构

mcp-claude-dev/
├── claude_dev_server/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py
│   └── file_manager.py
└── pyproject.toml

配置

要与Claude Desktop一起使用此服务器，请将其添加到您的Claude Desktop配置文件中：

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

添加以下配置：

{
  "mcpServers": {
    "claude-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_YOUR_PROJECT",
        "run",
        "-m",
        "claude_dev_server",
        "PATH_TO_YOUR_WORKSPACE"
      ]
    }
  }
}

替换：

• PATH_TO_YOUR_PROJECT 为您mcp-claude-dev目录的绝对路径
• PATH_TO_YOUR_WORKSPACE 为Claude应具有文件访问权限的目录的绝对路径

使用

1. 启动Claude Desktop
2. 该服务器将出现在工具菜单（锤子图标）中
3. 您现在可以请求Claude执行以下操作：
   • 读取文件：“你能读取file.txt的内容吗？”
   • 写入文件：“创建一个名为example.py的新文件，并在其中写入一个基本的Flask应用”
   • 列出目录：“当前目录里有哪些文件？”
   • 创建目录：“创建一个名为'src'的新目录”
   • 获取文件信息：“main.py的大小和修改日期是什么？”
   • 实现代码：“编写一个计算斐波那契数列的Python函数，并保存在math_utils.py中”

安全说明

• 服务器仅允许访问指定工作空间目录内的文件
• 所有文件操作需要相对于工作空间的显式路径
• 尝试在工作空间外进行目录遍历将被阻止
• 文件监控功能用于检测更改

开发

要为项目做贡献：

1. 克隆仓库
2. 安装开发依赖项
3. 进行修改
4. 在提交拉取请求前彻底测试

运行测试

python -m pytest tests/

可用工具

服务器公开了这些MCP工具：

• read_file(path: str) -> str: 读取文件内容
• write_file(path: str, content: str) -> str: 向文件写入内容
• list_files(path: str = "") -> str: 列出目录内容
• create_directory(path: str) -> str: 创建新目录
• get_file_info(path: str) -> str: 获取文件元数据
• implement_artifact(path: str, content: str) -> str: 保存代码工件

错误处理

服务器包括针对以下情况的强大错误处理：

• 无效路径
• 工作空间外的访问尝试
• 文件操作失败
• 权限问题

许可证

MIT许可证 - 欢迎自由使用和修改。

贡献

欢迎贡献！请阅读我们的贡献指南并提交任何改进的拉取请求。