项目简介

'claude-code-plugins-plus' 是一个丰富的 Claude Code 插件集合,其中包含了多个基于 Model Context Protocol (MCP) 实现的服务器端插件。这些 MCP 服务器作为独立的 Node.js 进程运行,并通过标准化 JSON-RPC 协议与 LLM 客户端(如 Anthropic Claude Code CLI)通信,提供高级的上下文管理和工具执行能力。它们旨在扩展 LLM 的功能,使其能够与外部系统交互、处理复杂任务并访问结构化数据。

主要功能点

  • 代码健康审计 ('project-health-auditor'): 分析代码库的复杂性、代码变更频率(Git churn)和测试覆盖率,帮助开发者识别技术债务和潜在问题,提升代码质量。
  • 会话式API调试器 ('conversational-api-debugger'): 通过加载 OpenAPI 规范和 HTTP 日志,帮助 LLM 客户端调试 REST API 的故障,提供详细的错误分析、原因识别和可重现的 cURL 命令生成。
  • 领域记忆代理 ('domain-memory-agent'): 构建一个轻量级知识库,支持文档存储、基于 TF-IDF 的语义搜索和摘要生成,无需依赖复杂的外部机器学习模型。
  • 设计转代码工具 ('design-to-code'): 能够将 Figma 设计文件或屏幕截图智能解析,并将其转换为 React、Svelte 或 Vue 等前端框架的生产级代码组件,同时注重可访问性(A11y)。
  • 工作流编排器 ('workflow-orchestrator'): 支持基于有向无环图(DAG)的任务编排和并行执行,非常适用于构建 CI/CD 管道、数据 ETL 流程和多阶段部署自动化。

安装步骤

  1. 克隆仓库: 首先,使用 Git 将 'claude-code-plugins-plus' 仓库克隆到您的本地机器: 'git clone https://github.com/jeremylongshore/claude-code-plugins-plus.git' 'cd claude-code-plugins-plus'

  2. 安装依赖: 进入您希望安装的 MCP 服务器插件的对应目录(例如,要安装 'project-health-auditor',请进入 'plugins/mcp/project-health-auditor' 目录)。然后安装其 Node.js 依赖: 'cd plugins/mcp/project-health-auditor' 'npm install' 或 'pnpm install'

  3. 构建/编译: 某些插件可能需要编译 TypeScript 代码。在插件目录中运行构建命令: 'npm run build' (如果 'package.json' 中定义了 'build' 脚本)

  4. 配置 Claude Code CLI: 在您的 Claude Code CLI 环境中,需要将此仓库添加为插件市场,然后安装所需的 MCP 服务器插件。具体安装命令在每个插件的 'README.md' 中通常有提供。例如,安装 'devops-automation-pack' 或 'project-health-auditor': ' /plugin marketplace add jeremylongshore/claude-code-plugins ' ' /plugin install devops-automation-pack@claude-code-plugins-plus ' ' /plugin install project-health-auditor@claude-code-plugins-plus '

服务器配置 (MCP 客户端用)

MCP 客户端(如 Claude Code CLI)在启动与这些 MCP 服务器的连接时,需要提供服务器的启动命令和参数。这些 MCP 服务器通常设计为通过标准 I/O(Stdio)进行 JSON-RPC 通信。

MCP 客户端的配置信息通常以 JSON 格式存储,包含 'serverName'、'command' 和 'args' 等字段。下面是一个概念性的配置示例,您需要根据实际安装路径进行调整:

// 这是一个示例配置,实际路径和参数请根据您的安装调整。
// 通常,Claude Code CLI 会自动处理大部分配置,您只需通过其界面安装插件。
// 如果需要手动配置,结构如下:
{
  "serverName": "project-health-auditor",
  "command": "/path/to/claude-code-plugins-plus/plugins/mcp/project-health-auditor/servers/code-metrics.ts",
  "args": [],
  "description": "代码健康审计MCP服务器,用于分析代码库的复杂性、变更频率和测试覆盖率。",
  "transport": "stdio"
}

请注意:

  • 'serverName': 服务器的唯一标识符,应与插件名称一致。
  • 'command': MCP 服务器可执行文件的绝对路径。例如,对于 'project-health-auditor',该路径通常指向 'plugins/mcp/project-health-auditor/servers/code-metrics.ts'。请确保此 TypeScript 文件已被编译为可执行的 JavaScript 文件,或者通过 'node' 命令执行(如 'node /path/to/.../code-metrics.ts')。
  • 'args': 启动服务器时需要传递的额外参数,通常为空数组 '[]'。
  • 'description': 服务器功能的简要说明。
  • 'transport': 通信协议,这里通常为 '"stdio"',表示通过标准输入输出进行通信。

对于其他 MCP 服务器,只需替换 'command' 路径为对应插件的 'servers/*.ts' 文件即可。例如:

  • 'conversational-api-debugger': '/path/to/.../plugins/mcp/conversational-api-debugger/servers/api-debugger.ts'
  • 'domain-memory-agent': '/path/to/.../plugins/mcp/domain-memory-agent/servers/knowledge-base.ts'
  • 'design-to-code': '/path/to/.../plugins/mcp/design-to-code/servers/design-converter.ts'
  • 'workflow-orchestrator': '/path/to/.../plugins/mcp/workflow-orchestrator/servers/workflow-engine.ts'

基本使用方法

安装并配置完成后,LLM 客户端即可通过其内置的机制与 MCP 服务器进行交互。通常,LLM 会根据对话上下文和您的需求自动调用相关的工具。

例如:

  • 要进行代码健康审计,您可以在 LLM 对话中提及 "请分析一下我的代码仓库健康状况",LLM 会自动调用 'project-health-auditor' 中的相关工具。
  • 要调试 API,可以说 "我需要调试这个 REST API 的故障",LLM 会激活 'conversational-api-debugger' 并引导您完成调试流程。
  • 要查找知识库中的信息,您可以提出相关问题,LLM 会使用 'domain-memory-agent' 进行语义搜索。

每个 MCP 服务器插件的具体功能和使用方式,都旨在通过自然的对话模式与 LLM 客户端无缝集成。

信息

分类

开发者工具