mcp-delphi-dmvc-docs

Servidor MCP (Model Context Protocol) com um guia completo e original do DelphiMVCFramework em português (PT-BR), mais de uma dúzia de snippets de código prontos para uso, indexados e pesquisáveis por ferramentas como Claude Code, Claude Desktop ou qualquer outro cliente MCP.

O guia foi escrito a partir da análise do código-fonte do DelphiMVCFramework (versão 3.4.3 "magnesium") — 34 capítulos cobrindo desde roteamento e middlewares até WebSockets, JSON-RPC 2.0, Repository Pattern multi-banco e views server-side (Mustache/TemplatePro/WebStencils).

Sobre licenciamento: o DelphiMVCFramework (o framework em si) é do Daniele Teti e contribuidores, licenciado em Apache License 2.0. O conteúdo do guia neste repositório é uma obra original, escrita pelo autor deste pacote a partir da leitura do código-fonte do framework — não é uma cópia de nenhum material comercial de terceiros. Veja LICENSE para detalhes.

O que este servidor oferece

Ferramenta	Para que serve
list_chapters	Lista os 34 capítulos do guia, agrupados por parte do livro
get_chapter	Retorna o texto completo de um capítulo (1–34)
get_chapter_summary	Retorna só o resumo de um capítulo
search_manual	Busca um termo em todos os capítulos e apêndices, com trechos de contexto
list_appendices	Lista os 4 apêndices (A–D)
get_appendix	Retorna o texto completo de um apêndice
get_http_status	Consulta o significado de um código HTTP_STATUS específico do DMVC
get_config_key	Consulta uma chave de configuração (TMVCConfigKey/.env)
get_snippet	Retorna um snippet de código pronto de uma categoria
list_snippets	Lista todos os snippets disponíveis, por categoria
search_snippets	Busca snippets por palavra-chave (nome ou conteúdo do código)

Categorias de snippets disponíveis

dmvc_controller, dmvc_auth, dmvc_orm, dmvc_rql, dmvc_middleware, dmvc_swagger, dmvc_jsonrpc, dmvc_websocket, dmvc_views, dmvc_config, dmvc_tls.

Instalação

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

claude mcp add delphi-dmvc-docs -- npx -y mcp-delphi-dmvc-docs

Opção 2 — instalar global via npm

npm install -g mcp-delphi-dmvc-docs
claude mcp add delphi-dmvc-docs -- mcp-delphi-dmvc-docs

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

git clone https://github.com/avelsys/mcp-delphi-dmvc-docs.git
cd mcp-delphi-dmvc-docs
npm install
npm run build
claude mcp add delphi-dmvc-docs -- 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-dmvc-docs": {
      "command": "npx",
      "args": ["-y", "mcp-delphi-dmvc-docs"]
    }
  }
}

Regenerando o guia a partir de uma versão mais nova do PDF

O conteúdo já vem pronto em data/manual.json — não é necessário rodar nada para usar o servidor. Mas se você quiser atualizar o guia a partir de uma nova versão do PDF-fonte:

npm run ingest -- caminho/para/DMVCFramework-Guia-Completo-PT-BR.pdf
# ou, via variável de ambiente:
DMVC_GUIDE_PDF=caminho/para/o.pdf npm run ingest

O script confere automaticamente se encontrou os 34 capítulos e 4 apêndices esperados e avisa se a estrutura do PDF mudou (veja scripts/ingest-manual.mjs).

Desenvolvimento

npm install
npm run watch   # tsc --watch

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 do guia (algum capítulo desatualizado em relação a uma versão nova do framework) ou novos snippets. Abra uma issue descrevendo o que mudou antes de um PR grande.

Licença

MIT — veja LICENSE.