io.github.avelsys/delphi-codecoverage
Guide + snippets for Delphi/DUnitX projects that work with the DelphiCodeCoverage tool.
Open source Open in the app JSON README (API)
About
Guide + snippets for Delphi/DUnitX projects that work with the DelphiCodeCoverage tool.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- avelsys
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-09-12T18:39:58Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-09-12 19:03:31
- Updated
- 2026-09-12 19:03:31
- Origin id
io.github.avelsys/delphi-codecoverage
README
# 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](https://github.com/DelphiCodeCoverage/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](./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)
```bash
claude mcp add delphi-codecoverage -- npx -y mcp-delphi-codecoverage
```
### Opção 2 — instalar global via npm
```bash
npm install -g mcp-delphi-codecoverage
claude mcp add delphi-codecoverage -- mcp-delphi-codecoverage
```
### Opção 3 — a partir do código-fonte
```bash
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`)
```json
{
"mcpServers": {
"delphi-codecoverage": {
"command": "npx",
"args": ["-y", "mcp-delphi-codecoverage"]
}
}
}
```
## Desenvolvimento
```bash
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](https://github.com/modelcontextprotocol/inspector):
```bash
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](./LICENSE).