mcp-delphi-codecoverage

Servidor MCP (Model Context Protocol) com um guia prático + snippets de código prontos para configurar projetos Delphi, testes DUnitX e scripts de CI de forma que funcionem corretamente com a DelphiCodeCoverage — indexado e pesquisável por ferramentas como Claude Code, Claude Desktop ou qualquer outro cliente MCP.

O guia foi escrito a partir da documentação e do código-fonte públicos do projeto DelphiCodeCoverage/DelphiCodeCoverage (README oficial, scripts .bat de exemplo) — cobre configuração de .dproj/Map file, estrutura de projeto runner DUnitX, uso da CLI CodeCoverage.exe, integração em CI e o padrão de separação Form/lógica (MVP) que torna Forms de fato cobríveis.

Sobre licenciamento: a DelphiCodeCoverage (a ferramenta em si) é licenciada em Mozilla Public License 2.0. O DUnitX é licenciado em Apache License 2.0. O conteúdo deste repositório (guia e snippets) é uma obra original, escrita pelo autor deste pacote a partir da documentação pública desses projetos — veja LICENSE para detalhes.

O que este servidor oferece

Ferramenta	Para que serve
list_topics	Lista os tópicos do guia
get_topic	Retorna o texto completo de um tópico
search_guide	Busca um termo em todos os tópicos, com trechos de contexto
get_snippet	Retorna um snippet pronto de uma categoria
list_snippets	Lista todos os snippets disponíveis, por categoria
search_snippets	Busca snippets por palavra-chave (nome ou código)

Tópicos disponíveis

project-setup (Map file/.dproj), dunitx-runner (projeto console runner), cli-usage (parâmetros da CodeCoverage.exe), ci-integration (pipeline build → testes → cobertura), form-mvp-pattern (como manter Forms cobríveis via separação MVP).

Categorias de snippets disponíveis

unit_skeleton, dunitx_test_fixture, dunitx_console_dpr, dproj_coverage_settings, cli_invocation, ci_script_windows.

Instalação

Opção 1 — via npx (recomendado, sem instalar nada globalmente)

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

Opção 2 — instalar global via npm

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

Opção 3 — a partir do código-fonte

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"

Depois de registrado, o servidor fica disponível em qualquer projeto (escopo user) ou só no projeto atual (--scope local, se preferir isolar).

Configuração manual (claude_desktop_config.json ou .mcp.json)

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

Desenvolvimento

npm install
npm run watch   # tsc --watch

Conteúdo do guia e dos snippets vive direto em src/topics.ts e src/snippets.ts (TypeScript puro, sem etapa de ingest/build de dados) — para atualizar, edite esses arquivos e rode npm run build.

O servidor usa stdio (StdioServerTransport) — para testar localmente sem um cliente MCP completo, use o MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Contribuindo

Issues e PRs são bem-vindos — principalmente correções de conteúdo (algum parâmetro de CLI desatualizado em relação a uma versão nova da DelphiCodeCoverage) ou novos snippets. Abra uma issue descrevendo o que mudou antes de um PR grande.

Licença

MIT — veja LICENSE.