使用说明

项目简介

MCP Local Dev 是一个本地开发环境管理服务器，它基于 Model Context Protocol (MCP) 构建，旨在让 AI 助手（如 Claude）能够自动化配置和管理本地开发环境。开发者可以通过自然语言指令，让 AI 助手完成环境搭建、依赖管理、运行测试等任务，从而更专注于核心的开发工作。

主要功能点

自动化环境搭建: 支持根据 GitHub 仓库或本地项目自动创建隔离的开发环境。
运行时支持: 支持 Python (UV), Node.js (NPM), Bun 等多种运行时环境。
测试运行: 集成 pytest, unittest, Jest, Vitest 等多种测试框架，并提供详细的测试报告和覆盖率信息。
环境管理: 提供环境隔离、自动清理等功能，确保开发环境的干净和安全。
零配置: 开箱即用，无需复杂配置即可快速上手。

安装步骤

安装 Claude Desktop: 请根据 MCP 快速入门指南安装 Claude Desktop (或其他兼容 MCP 协议的客户端)。
配置 Claude Desktop: 在 Claude Desktop 的配置文件中添加以下服务器配置信息。

服务器配置

以下 JSON 配置信息用于告知 MCP 客户端如何启动和连接 MCP Local Dev 服务器。您需要将这段配置添加到您的 MCP 客户端（例如 Claude Desktop）的服务器配置中。

{
  "servers": {
     "local_dev": {  // 服务器名称，可以自定义
      "command": "uvx",  // 启动服务器的命令，这里使用 uvx (由 uv 包管理器提供的命令运行器)
      "args": [  // 启动服务器命令的参数
        "--from",  // 指定从哪里安装
        "git+https://github.com/txbm/mcp-local-dev@main", // 从 GitHub 仓库 txbm/mcp-local-dev 的 main 分支安装
        "mcp-local-dev" //  安装后要运行的模块或命令，这里是 mcp-local-dev
      ]
    }
  }
}

基本使用方法

启动 MCP 服务器: 配置完成后，MCP 客户端 (Claude Desktop) 应该能够自动启动 MCP Local Dev 服务器。
连接 GitHub 仓库: 在 MCP 客户端中，您可以指示 AI 助手 (Claude) 连接到任何 GitHub 仓库，例如，您可以提问： "帮我设置 [GitHub 仓库 URL] 的开发环境"。
自动化开发任务: 您可以指示 AI 助手执行各种开发任务，例如：
- "运行测试并报告覆盖率"
- "查看代码"
- "清理开发环境"

注意: MCP Local Dev 服务器需要在安装了 Python 和 Node.js/Bun 运行时的环境中运行。请确保您的系统已安装这些运行时环境，并已将 'uvx', 'uv', 'node', 'npm', 'bun' 等命令添加到系统 PATH 环境变量中。

关键词

使用说明

信息