使用说明

项目简介

mcp-dev-server 是一个基于 Model Context Protocol (MCP) 构建的开发服务器，旨在为 Claude 等 LLM 客户端提供软件开发项目的上下文信息和工具能力。它通过 Docker 环境隔离和执行代码，支持项目结构管理、文件操作、模板化项目创建和 Git 集成，使 LLM 能够更好地理解和操作软件开发项目。

主要功能点

项目上下文管理: 集中管理软件开发项目的各种信息，使 LLM 能够理解项目的整体结构和状态。
文件系统操作: 允许 LLM 访问和操作项目文件，例如读取、创建、修改和删除文件。
模板化项目创建: 支持基于预定义模板快速创建新项目，简化项目初始化流程。
Git 集成: 集成 Git 版本控制系统，方便 LLM 进行代码版本管理和协作。
Docker 环境: 使用 Docker 容器隔离和执行代码，提供安全可控的代码执行环境。
资源管理: 提供项目结构、构建状态、测试结果、Docker 容器状态等资源的访问接口。
工具注册与执行: 支持项目初始化、构建、测试、Docker 命令等工具的注册和 LLM 调用。
Prompt 模板: 内置项目分析、开发建议、错误诊断等 Prompt 模板，优化 LLM 交互体验。

安装步骤

环境准备: 确保已安装 Python 3.12 或更高版本、Docker 和 Git。
安装 mcp-dev-server: 打开终端，运行以下命令安装 mcp-dev-server。
```
pip install mcp-dev-server
```

服务器配置

要将 mcp-dev-server 集成到 MCP 客户端 (如 Claude Desktop)，需要编辑客户端的配置文件，添加 mcpServers 配置项。以 Claude Desktop 为例，配置文件路径如下：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在配置文件中添加以下 JSON 配置，以注册名为 "dev" 的 MCP 服务器：

{
  "mcpServers": {
    "dev": {
      "command": "mcp-dev-server", // MCP 服务器启动命令
      "args": []                   // 启动参数，当前配置为空
    }
  }
}

配置说明:

'"dev"': 服务器名称，可以自定义，用于在客户端中标识和选择服务器。
'"command": "mcp-dev-server"': 指定启动 mcp-dev-server 的命令。确保该命令在您的系统 PATH 环境变量中，或者使用完整路径。
'"args": []': 启动参数列表，当前配置为空，表示使用默认配置启动服务器。

基本使用方法

mcp-dev-server 作为一个 MCP 服务器在后台运行，并与 MCP 客户端通过 JSON-RPC 协议进行通信。您无需直接操作服务器，而是通过配置好的 MCP 客户端 (如 Claude) 与其交互。

配置完成后，在 MCP 客户端中选择已配置的 "dev" 服务器，即可体验以下功能：

资源访问: LLM 可以通过 MCP 协议请求访问项目资源，例如项目文件结构、文件内容、构建和测试状态等。
工具调用: LLM 可以调用服务器提供的工具，例如初始化项目、执行构建、运行测试、管理 Docker 容器等，以完成软件开发任务。
Prompt 交互: 利用预定义的 Prompt 模板，LLM 可以进行项目分析、代码建议、错误诊断等更智能的交互。

具体的功能使用和操作界面取决于您使用的 MCP 客户端。请参考相应 MCP 客户端的文档，了解如何利用配置的 MCP 服务器增强 LLM 的开发能力。

关键词