delphi-codecoverage

mcp-delphi-codecoverage

MCP（Model Context Protocol）服务，提供实用指南和现成代码片段，用于配置 Delphi 项目、DUnitX 测试和 CI 脚本，使其能够与 DelphiCodeCoverage 正常配合使用——内容已建立索引，可供 Claude Code、Claude Desktop 或任何其他 MCP 客户端使用工具进行搜索。

本指南根据项目 DelphiCodeCoverage/DelphiCodeCoverage 的公开文档和源代码（官方 README、示例 .bat 脚本）编写，涵盖 .dproj/Map file 配置、DUnitX runner 项目结构、CodeCoverage.exe CLI 的使用、CI 集成，以及使 Forms 真正可覆盖的 Form/逻辑分离（MVP）模式。

关于许可：DelphiCodeCoverage（工具本身）采用 Mozilla Public License 2.0 许可。DUnitX 采用 Apache License 2.0 许可。本仓库的内容（指南和代码片段）是软件包作者根据这些项目的公开文档撰写的原创作品——详情请参阅 LICENSE。

此服务提供的内容

工具	用途
list_topics	列出指南主题
get_topic	返回主题的完整文本
search_guide	在所有主题中搜索术语，并显示上下文片段
get_snippet	返回指定类别的现成代码片段
list_snippets	按类别列出所有可用的代码片段
search_snippets	按关键词（名称或代码）搜索代码片段

可用主题

project-setup（Map file/.dproj）、dunitx-runner（控制台 runner 项目）、cli-usage（CodeCoverage.exe 参数）、ci-integration（流水线 build → 测试 → 覆盖率）、form-mvp-pattern（如何通过 MVP 分离使 Forms 可覆盖）。

可用代码片段类别

unit_skeleton、dunitx_test_fixture、dunitx_console_dpr、dproj_coverage_settings、cli_invocation、ci_script_windows。

安装

选项 1——通过 npx（推荐，无需全局安装）

claude mcp add delphi-codecoverage -- npx -y mcp-delphi-codecoverage

选项 2——通过 npm 全局安装

npm install -g mcp-delphi-codecoverage
claude mcp add delphi-codecoverage -- mcp-delphi-codecoverage

选项 3——从源代码安装

git clone https://github.com/avelsys/mcp-delphi-codecoverage.git
cd mcp-delphi-codecoverage
npm install
npm run build
claude mcp add delphi-codecoverage -- node "$(pwd)/build/index.js"

注册后，该服务可在任何项目中使用（user 范围），也可以仅在当前项目中使用（如果希望隔离，可使用 --scope local）。

手动配置（claude_desktop_config.json 或 .mcp.json）

{
  "mcpServers": {
    "delphi-codecoverage": {
      "command": "npx",
      "args": ["-y", "mcp-delphi-codecoverage"]
    }
  }
}

开发

npm install
npm run watch   # tsc --watch

指南和代码片段的内容直接存放在 src/topics.ts 和 src/snippets.ts 中（纯 TypeScript，无需数据导入或构建步骤）——要更新内容，请编辑这些文件并运行 npm run build。

该服务使用 stdio（StdioServerTransport）——要在没有完整 MCP 客户端的情况下进行本地测试，请使用 MCP Inspector：

npx @modelcontextprotocol/inspector node build/index.js

贡献

欢迎提交 Issues 和 PR，尤其是内容修正（例如 CLI 参数与新版 DelphiCodeCoverage 不再匹配）或新增代码片段。提交较大的 PR 前，请先创建 issue 说明变更内容。

许可证

MIT——请参阅 LICENSE。