LocalMCPChatClient

August 7, 2026 · View on GitHub

Gemma 4 E2B/E4Bをローカルで実行し、MCPツールを人間の承認付きで利用できるWindows向けチャットクライアントです。モデル推論、会話履歴、MCP設定は端末内に保存され、アプリからテレメトリやクラウドLLMへの送信は行いません。

現在のバージョンは0.1.2です。変更内容はCHANGELOGを参照してください。

Important

0.1.1は配布物のライセンス表示を修正したリリースです。0.1.0の配布物では第三者ライセンス通知を確認できないため、0.1.1以降を使用してください。

Warning

MCPサーバーは、承認後にファイルやネットワークへアクセスする可能性があります。信頼できるサーバーだけを登録し、承認画面に表示されるツール名と引数を確認してください。

現在の機能

  • Gemma 4 E2B/E4B公式Instruction Tuned QAT GGUF、および任意のローカルGGUF
  • アプリ管理のllama-serverによるOpenAI互換SSEストリーミング
  • Auto / CPU / NVIDIA CUDA / Vulkan推論、起動時プリロード、生成停止、再生成、モデル切り替え
  • ハードウェアに応じた自動バックエンド選択、任意の速度診断、初回応答時間と生成速度の表示
  • MCP C# SDKによるstdio / Streamable HTTP接続
  • servers / mcpServers形式のJSONからのMCPサーバー設定インポート
  • Tool Callの引数検証、「今回のみ許可」「常に許可」「拒否」と実行結果表示
  • SQLiteによる会話履歴、Markdown対応チャット表示、会話単位のMarkdown保存
  • Windows Credential Managerを利用したMCP資格情報の保存
  • 推論・モデル登録・MCP・承認・資格情報をまとめて初期化する設定リセット
  • 再開可能ダウンロード、空き容量確認、SHA-256検証、既存ファイルのインポート
  • self-contained win-x64 Portable発行
  • 配布物へのライセンス通知同梱と、設定画面からのライセンス表示

初期版では、テキストチャットとMCP Toolsを対象とします。クラウドLLM、マルチモーダル入力、MCP Resources / Prompts、旧SSE transport、OAuth、非Windows GUIは対象外です。

画面とMCP連携例

LocalMCPChatClient接続先のMCPサーバーアプリ
Gemma 4とMCPツールについて会話しているLocalMCPChatClientのメイン画面MCP Serverパネルを開いたD3D12LookDevPT
ローカルGemmaが接続済みToolsを理解し、日本語で説明している画面D3D12LookDevPTのレンダラー画面。MCP Serverパネルからローカルエンドポイントを起動する

この例では、LocalMCPChatClientからD3D12/DXRレンダラーへ接続し、利用可能な機能の確認や露出変更をチャットで行っています。接続からTool Call確認までの手順はD3D12LookDevPTとの連携例を参照してください。4枚目の画面は別リポジトリのMCPサーバーアプリであり、本アプリや配布物には含まれません。

すぐに使う

GitHub Releaseでは次の2形式を配布します。どちらも.NETランタイムの追加インストールは不要です。

成果物用途
LocalMCPChatClient-0.1.2-win-x64.zip展開して使う通常のPortable版。構成ファイルを確認しやすい
LocalMCPChatClient-0.1.2-win-x64.exeアプリ本体を1ファイルにまとめたself-contained版

SHA-256ファイルも各成果物と一緒に配布します。単体EXEにはモデルとllama-serverは含まれず、ネイティブ依存関係は実行時に一時ディレクトリへ展開される場合があります。

Portable ZIPにはLICENSE.txt、THIRD-PARTY-NOTICES.txt、詳細なlicensesフォルダーを同梱します。単体EXEでは「設定」→「承認とプライバシー」→「ライセンス情報を表示」から、同じライセンスと第三者通知を確認できます。Releaseにはアプリ本体のライセンスと第三者通知も個別ファイルとして添付します。

Portable ZIPを使う場合は任意の書き込み可能なフォルダーへ展開し、LocalMCPChatClient.exeを起動します。単体EXEはダウンロードしたファイルを直接起動できます。

初回セットアップでは次を行います。

  1. 検出されたハードウェアを確認する
  2. Gemma 4 E2BまたはE4Bを選択する
  3. CPU / CUDA / Vulkanバックエンドを選択する
  4. 各コンポーネントのライセンスを確認する
  5. 「ダウンロードして開始」を選択する

モデルとllama-serverを既に持っている場合は「既存ファイルを使用」から登録できます。詳しい手順ははじめにを参照してください。

動作環境

項目内容
対応OSWindows 10/11 x64
アプリのターゲットnet9.0-windows / net9.0
開発SDK.NET 10 SDK 10.0.300以降（global.jsonで選択）
Visual StudioVisual Studio Community 2026で検証済み。「.NETデスクトップ開発」ワークロードが必要
GPUCUDAは対応NVIDIAドライバー、VulkanはVulkan対応ドライバーが必要

組み込みカタログ上のモデルサイズは約3.35 GB（E2B）または5.15 GB（E4B）です。ダウンロード途中ファイルと展開先を含む十分な空き容量を確保してください。

開発を始める

git clone https://github.com/shaderjp/LocalMCPChatClient.git
cd LocalMCPChatClient
./scripts/bootstrap.ps1

その後、LocalMCPChatClient.slnをVisual Studioで開き、LocalMCPChatClient.Appをスタートアッププロジェクトにします。CLIから起動する場合は次を実行します。

dotnet run --project src/LocalMCPChatClient.App/LocalMCPChatClient.App.csproj

Visual StudioとCLIの詳しい手順は開発ガイドを参照してください。

ドキュメント

資料対象内容
はじめに利用者インストール、初回セットアップ、最初のチャット
操作ガイド利用者画面、推論設定、履歴、ツール承認
MCP設定ガイド利用者・MCP開発者stdio / HTTP設定、秘密情報、接続項目
D3D12LookDevPTとの連携例利用者MCPサーバーの起動、接続、チャットからのレンダラー操作
トラブルシューティング利用者・開発者推論、モデル、MCP、設定、ログの確認方法
開発ガイド開発者Visual Studio、ビルド、テスト、発行、リポジトリ規約
リリース手順メンテナーバージョン更新、成果物検証、タグとGitHub Release
アーキテクチャ開発者プロジェクト境界、推論・MCP・保存の設計
MCPプロファイル例開発者保存されるJSON形状の参考例

保存場所

データ既定の場所
一般設定、MCPプロファイル%LocalAppData%\LocalMCPChatClient\settings.json
SQLite会話履歴%LocalAppData%\LocalMCPChatClient\history.db
モデル%LocalAppData%\LocalMCPChatClient\Models（変更可）
llama.cpp%LocalAppData%\LocalMCPChatClient\Runtimes
一時ダウンロード%LocalAppData%\LocalMCPChatClient\Downloads
診断ログ%LocalAppData%\LocalMCPChatClient\Logs

秘密として入力したMCPヘッダーと環境変数はWindows Credential Managerに保存され、settings.jsonには参照名だけが記録されます。モデル、ランタイム、DB、ログはGit管理対象外です。

ビルドとテスト

dotnet restore LocalMCPChatClient.sln
dotnet build LocalMCPChatClient.sln -c Release --no-restore
dotnet test LocalMCPChatClient.sln -c Release --no-build
dotnet publish src/LocalMCPChatClient.App/LocalMCPChatClient.App.csproj `
  -c Release -r win-x64 --self-contained true -o artifacts/portable
dotnet publish src/LocalMCPChatClient.App/LocalMCPChatClient.App.csproj `
  -c Release -p:PublishProfile=win-x64-single-file -o artifacts/single-file

GitHub ActionsでもWindows上でrestore、build、test、Portable ZIPと単体EXEの発行、SHA-256作成、大容量ファイル検査を実行します。

ライセンス

本リポジトリのソースコードはMIT Licenseです。アプリに同梱するライブラリと.NET/WPFランタイムの通知はTHIRD-PARTY-NOTICES.txtおよびlicensesに収録しています。ダウンロードされるモデルと推論ランタイムには、それぞれの配布元ライセンスが適用されます。