项目简介

DevServer MCP 是一个专门用于实时监控本地开发服务器日志的 Model Context Protocol (MCP) 服务器。它能智能识别 TypeScript、Svelte 和 Vite 等项目中的错误模式，对错误进行分类（如严重性、类型），并将其与近期文件更改关联起来。通过 Server-Sent Events (SSE) 传输协议，DevServer MCP 可以向 LLM 客户端（如 Claude Code）提供即时、结构化的错误通知和诊断工具，从而显著提升开发人员的调试效率。

主要功能点

实时错误通知: 当开发服务器出现错误时，通过 SSE 即时向连接的 LLM 客户端推送通知。
智能日志解析: 自动识别并解析 TypeScript 编译错误、Svelte 警告、Vite 构建失败、网络错误、运行时 JavaScript 错误等。
错误关联: 将错误信息与最近的文件更改进行关联，帮助快速定位问题源头。
错误分类与严重性: 对错误进行分类（如 TypeScript、Svelte、Vite、网络、构建、运行时等）并评估其严重性（关键、警告、信息）。
多客户端支持: 支持同时连接多个 LLM 客户端实例。
丰富的 MCP 工具: 提供多个工具供 LLM 客户端调用，以获取开发服务器状态、错误摘要、文件相关错误、历史错误记录、错误监控概览以及项目配置建议等。

安装步骤

前置条件: 确保您的开发环境中已安装 Node.js 和 pnpm (或 npm/yarn)。

克隆仓库:

git clone https://github.com/mntlabs/devserver-mcp.git
cd devserver-mcp

安装依赖并构建:

pnpm install && pnpm build

或者使用 npm:

npm install && npm run build

服务器配置

DevServer MCP 允许您通过命令行参数 '--port' 和 '--monitor' 来启动并配置其行为。它会监听指定端口以提供 MCP 服务，并可以同时监控您本地的开发服务器。

MCP 客户端连接配置示例（JSON格式，假设您使用 Claude Code 客户端） 当您将 DevServer MCP 作为一个 MCP 服务器添加到您的 LLM 客户端时，您需要提供以下配置信息。这些配置通常以 JSON 格式存储，具体细节取决于您的 LLM 客户端。

{
  "servers": [
    {
      "name": "devserver-mcp-frontend",
      "transport": "sse",
      "url": "http://127.0.0.1:9338/sse",
      "description": "监控前端开发服务器的实时错误和状态，默认端口"
    },
    {
      "name": "devserver-mcp-backend",
      "transport": "sse",
      "url": "http://127.0.0.1:9339/sse",
      "description": "监控后端API开发服务器的实时错误和状态，自定义端口"
    }
  ]
}

'name': 为您的 MCP 服务器实例提供一个易于识别的唯一名称（例如 'devserver-mcp-frontend'）。
'transport': 指定通信协议，这里使用 'sse' (Server-Sent Events)。
'url': MCP 服务器的接入地址，通常是 'http://127.0.0.1:<端口>/sse'。请确保端口与您启动 DevServer MCP 时使用的端口一致。
'description': 对该 MCP 服务器实例的简要描述，帮助您区分不同的监控对象。

基本使用方法

启动 DevServer MCP 并监控您的开发服务器: 在您的项目根目录中，打开终端，使用以下命令启动 DevServer MCP。它将同时启动并监控您本地的开发服务器进程，捕获所有日志并进行解析。
- 使用默认端口 9338 监控 'pnpm run dev' 命令:
```
node dist/server.js --monitor pnpm run dev
```
- 指定端口（例如 9339）监控 'npm run dev:api' 命令:
```
node dist/server.js --port 9339 --monitor npm run dev:api
```
此命令会启动一个 HTTP 服务器，并指示 DevServer MCP 在后台运行并监控您的开发服务器进程。所有开发服务器的日志都会被捕获和解析。

连接 Claude Code (或其他 MCP 客户端): 在您的 LLM 客户端（例如 Claude Code）中，打开终端或配置界面，使用 'claude mcp add' 命令连接到 DevServer MCP。

连接到默认端口 9338 的 DevServer MCP:

claude mcp add --transport sse devserver-mcp http://127.0.0.1:9338/sse

连接到自定义端口（例如 9339）的 DevServer MCP，并为其命名为 "my-frontend-devserver":

claude mcp add --transport sse my-frontend-devserver http://127.0.0.1:9339/sse

连接成功后，当您的开发服务器产生错误时，Claude Code 将收到即时通知。

通过 LLM 客户端使用工具: 连接后，您可以通过 LLM 客户端（如 Claude Code）直接提问或调用 DevServer MCP 提供的工具来查询开发服务器状态、错误信息等。以下是一些您可以尝试的示例：
- "告诉我开发服务器的当前状态。" (调用 'get_dev_server_status' 工具)
- "给我一个最新的错误摘要。" (调用 'get_error_summary' 工具)
- "获取文件 'src/App.svelte' 的所有错误。" (调用 'get_file_errors' 工具)
- "清除所有历史错误。" (调用 'clear_error_history' 工具)
- "查看最近的错误和文件变更关联。" (调用 'watch_for_errors' 工具)
- "建议我如何配置MCP监控。" (调用 'suggest_monitoring_setup' 工具)

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息