Wick

MCP経由で公開される、Roslynで強化されたGodot Engine用C#例外テレメトリ。

👁 CI
👁 License: MIT

Wickとは？

Godot C#ゲームがクラッシュした際、AIアシスタントは生のスタックトレースを見るだけで、ファイルを順番に開くよう8回以上もやり取りを繰り返すことになります。Wickはその例外をキャプチャし、Roslynを活用したソースコンテキスト（実際のメソッド本体、呼び出し元チェーン、最近のログ、シーンの状態）で強化し、1回の呼び出しでAIに全体像を伝えます。診断までのやり取りは10回から1回に短縮されます。

Wickの特長

他のGodot MCPサーバー（優れたGoPeakなど）は、シーン操作やGDScriptツールに重点を置いています。WickはC#/.NET開発者のエクスペリエンスに重点を置いています：

• Roslynで強化された例外テレメトリ -- stderrでキャプチャされたC#例外を、呼び出し元のメソッド本体、周囲のソース行、囲んでいる型、呼び出し元チェーンで強化します。これを行うGodot MCPサーバーは他にありません。

• プロセス内例外キャプチャ -- オプションのWick.Runtime NuGetコンパニオンにより、stderrでは見えないTaskScheduler.UnobservedTaskExceptionや非同期例外をキャプチャします。

• ソースコンテキスト付きビルド診断 -- ランタイム例外と同じパイプラインを通じて、Roslynソースコンテキストで強化されたdotnet buildエラーを提供します。

• C#分析ツール -- Roslynワークスペースを介したシンボルの検索、参照の検索、メンバーシグネチャの取得。

• 5つの柱からなるツールグループシステム -- 必要なものだけを有効化可能：core、runtime、csharp、build、scene。

Related MCP server: GodotIQ

はじめに

前提条件

• .NET 10 SDK (10.0.201以降)

• Godot 4.6.1+ (.NET/Monoサポート版)

インストール

Wickは、Godot側のブリッジアドオン（/addons/wick/）と.NET MCPサーバーの2つのパーツで構成されています。

Godotブリッジ — エディタ内のGodotアセットライブラリからインストール（推奨）、または/addons/wick/をプロジェクトに手動でコピーしてください。

MCPサーバー — クローンしてビルドします：

git clone https://github.com/buildepicshit/Wick.git
cd Wick
dotnet build Wick.slnx --configuration Release -maxcpucount:1

MCP設定

AIコーディングアシスタントのMCP設定にWickを追加します：

{
 "mcpServers": {
 "wick": {
 "command": "dotnet",
 "args": ["run", "--project", "path/to/Wick/src/Wick.Server"],
 "env": {
 "WICK_GROUPS": "core,runtime,csharp,build",
 "WICK_GODOT_BIN": "/path/to/godot",
 "WICK_PROJECT_PATH": "/path/to/your/godot-project"
 }
 }
 }
}

ツールグループ

WICK_GROUPS環境変数または--groups CLIフラグを使用してツールグループを有効化します：

例: WICK_GROUPS=core,runtime,csharp,build または --groups=all。

オプション: Wick.Runtimeコンパニオン

プロセス内の例外キャプチャ（非同期例外、TaskScheduler.UnobservedTaskException）およびライブシーンツリークエリを行うには、Wick.Runtime NuGetコンパニオンをGodot C#プロジェクトに追加してください：

dotnet add package Wick.Runtime

ゲームのエントリポイントにInstall()とTick()の両方を組み込んでください（両方必須です）：

using Wick.Runtime;

public partial class Main : Node
{
 public override void _Ready() => WickRuntime.Install();

 public override void _Process(double delta) => WickRuntime.Tick();
}

プロセス内ブリッジツール（runtime_query_scene_treeなど）が応答しなくなる場合は、Tick()を忘れています。 Install()単体でも例外キャプチャはカバーされますが、ライブRPCハンドラがメインスレッドのディスパッチャを処理するにはTick()が必要です。詳細はdocs/getting-started.mdおよびパッケージのREADMEを参照してください。

アーキテクチャ

Wickは外部プロセスとして実行されます。Godot内部では実行されません。通信：

• stdio -- AIクライアントへのMCPプロトコル

• TCP 6505 -- エディタブリッジ（GodotプラグインからWickサーバーへ）

• TCP 7777 -- ランタイムブリッジ（実行中のゲームからWickサーバーへ）

• TCP 7878 -- Wick.Runtimeコンパニオンブリッジ（プロセス内からWickサーバーへ）

このアーキテクチャにより、Wickサーバーとプロバイダープロジェクトは.NET 10をターゲットにでき、一方でオプションのプロセス内Wick.RuntimeコンパニオンはGodot 4.6.1の現在の安定版.NETランタイムに合わせてnet8.0を維持できます。

クレジット

WickはGoPeak (MIT License, (c) 2025 Solomon Elias / HaD0Yun) に触発されたクリーンルーム実装です。詳細なクレジットはATTRIBUTION.mdを参照してください。

貢献

貢献を歓迎します！PRを提出する前にCONTRIBUTING.mdをお読みください。

デモ

リポジトリをクローンし、ブラウザでdocs/demo/player.htmlを開いてデモを見るか、キャストファイルを直接再生してください：

asciinema play docs/demo/wick-demo.cast

ライセンス

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• detect_languageB
• gd_lsp_connectA
• gd_lsp_definitionA
• gd_lsp_hoverB
• gd_lsp_symbolsB
• gd_script_statusA
• godot_statusB
• project_infoA