delphi-codecoverage

mcp-delphi-codecoverage

DelphiCodeCoverage が正しく動作するように、Delphi プロジェクト、DUnitX テスト、CI スクリプトを設定するための実践ガイドと、すぐに使えるコードスニペットを備えた MCP（Model Context Protocol）サーバーです。DelphiCodeCoverage の内容をインデックス化しており、Claude Code、Claude Desktop、その他の MCP クライアントから検索できます。

このガイドは、プロジェクト DelphiCodeCoverage/DelphiCodeCoverage の公開ドキュメントとソースコード（公式 README、サンプルの .bat スクリプト）をもとに作成されています。.dproj／Map file の設定、DUnitX ランナープロジェクトの構成、CLI CodeCoverage.exe の使用方法、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（コンソールランナープロジェクト）、 cli-usage（CodeCoverage.exe のパラメーター）、ci-integration（ビルド → テスト → カバレッジのパイプライン）、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

コントリビューション

Issue や PR を歓迎します。特に、コンテンツの修正（新しいバージョンの DelphiCodeCoverage に対して古くなった CLI パラメーターなど）や、新しいスニペットを歓迎します。大規模な PR を作成する前に、変更内容を説明する Issue を作成してください。

ライセンス

MIT — LICENSE をご覧ください。