GoodVibes MCP 服务端插件集合

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了若干基于 MCP（Model Context Protocol）的服务器端组件，旨在向大语言模型客户端提供统一的“上下文信息与功能服务”。核心能力包括：托管和管理资源（Resources）、注册与执行工具（Tools）、定义与渲染 Prompt 模板（Prompts）。服务器通过 JSON-RPC 与客户端进行请求与响应，支持会话管理与能力声明，并提供多种传输协议的实现。

• 主要功能点

  • MCP 服务器集：包含前端分析引擎、项目引擎、以及其他专用引擎（如精准引擎、批处理引擎等）的服务器实现，彼此独立但共用 MCP 约束。
  • 资源与工具管理：每个服务器实现了工具集合的注册、查询与调用能力，支持按名称检索工具描述、执行调用等流程。
  • 会话与能力声明：服务器在启动时声明自身能力（如可提供的工具、引擎版本、名称等），并处理运行时错误。
  • 传输与扩展性：提供多种传输实现（如 Stdio、SSE、WebSocket），以便在不同环境下接入 Claude Code 客户端或其他 MCP 客户端。
  • 配置驱动：包含插件配置、服务器清单、以及 MCP 服务器的启动参数等，便于按需扩展与替换。

• 安装步骤

  • 克隆仓库到本地或在你的开发环境中下载。
  • 进入具体引擎模块（如 frontend-engine、project-engine 等）所在目录，安装依赖（如 npm install）。
  • 构建发出可执行的服务器（通常通过项目自带的构建脚本完成，如 npm run build），生成 dist/... 的服务器入口文件。
  • 启动服务器（各引擎在其实现中提供 start 方法，或通过 CLI/脚本启动），确保 Node.js 版本与依赖版本符合要求。

• 服务器配置（用于 MCP 客户端连接的配置信息，JSON 格式，包含 server 名称、启动命令和参数）

  • 服务器名称要与仓库实现中的服务名称一致，例如 frontend-engine、project-engine、precision-engine、batch-engine 等。
  • 启动命令通常为 node，加上 dist/xxx/server.js 的入口路径，以及必要的工作目录和环境变量。下方给出描述性文本示例，实际以你本地环境的启动为准。

  配置示例（非代码文本描述）

  • 服务器名称：frontend-engine
  • 启动命令（command）：node
  • 启动参数（args）：dist/frontend-engine/server.js
  • 注意：客户端连接 MCP 服务器需要的名称、命令、参数等信息以此 JSON 配置提供给客户端，用于建立连接。实际使用时无需该配置 Block 给终端用户查看，但以下描述便于理解：
  • serverName: "frontend-engine" command: "node" args: ["dist/frontend-engine/server.js"] 说明：启动入口为前端分析引擎 MCP 服务，监听标准输出/输入通信或其他传输通道。

  以上同理可应用于：

  • plugin_goodvibes_precision-engine
  • plugin_goodvibes_batch-engine
  • plugin_goodvibes_project-engine 以及仓库中其他相关引擎的启动组合。

• 基本使用方法

  • 启动后，MCP 客户端（如 Claude Code）通过指定的服务器名称和工具名称，向 MCP 服务器发送 JSON-RPC 请求来读取资源、调用工具、获取 Prompts 等。
  • 通过 mcp-cli 或集成的客户端库向具体服务器发起调用，服务器将返回 JSON-RPC 响应或通知。
  • 客户端在首次连接时应读取服务器的工具清单（ListTools）以了解可用工具及其参数，并按照工具描述进行调用。
  • 如遇错误，服务器会返回标准的错误响应，客户端应读取 error 字段以定位问题并重试或调整请求参数。

• 额外信息

  • 该仓库提供了完整的服务器实现、工具描述、以及多引擎协作能力，便于将来扩展新的 MCP 服务端能力与工具。