MCP Server Arcgis Pro Addin

🚀 ArcGIS Proアドイン付きMCPサーバー (C# .NET 8)

このリポジトリは、モデルコンテキストプロトコル (MCP) サーバー と ArcGIS Proアドイン を統合する方法を示しています。目的は、ArcGIS Proの機能をMCPツールとして公開し、GitHub Copilot (エージェントモード) や任意のMCPクライアントがGIS環境と対話できるようにすることです。

🚀 クイックスタート

このプロジェクトを使用することで、Copilot (エージェントモード) がArcGIS Pro内で直接地図をクエリし、レイヤーを一覧表示し、フィーチャーをカウントし、レイヤーにズームするなどの操作が可能になります。

✨ 主な機能

• ArcGIS Proアドイン (ArcGIS Pro SDKを使用したC#)：ArcGIS Proと 同じプロセス内 で実行され、ローカルのIPCチャネル (名前付きパイプ) を介してGIS操作を公開します。
• MCPサーバー (.NET 8コンソールアプリ)：MCPツールを定義し、名前付きパイプを介してアドインと通信し、Visual Studioで .mcp.json を通じてMCPサーバーとして構成されます。

📦 インストール

前提条件

• Visual Studio 2022 17.14以上 (MCPエージェントモードのサポートのため)
• .NET用ArcGIS Pro SDK
• ArcGIS Proのインストール (同一マシン)
• .NET 8 SDK

💻 使用例

ソリューション構造

ArcGisProMcpSample/
+- ArcGisProBridgeAddIn/           # ArcGIS Proアドインプロジェクト (同じプロセス内)
¦  +- Config.daml
¦  +- Module.cs
¦  +- ProBridgeService.cs          # 名前付きパイプサーバー + コマンドハンドラー
¦  +- IpcModels.cs                 # IPCリクエスト/レスポンスのDTO
+- ArcGisMcpServer/                # MCPサーバープロジェクト (.NET 8)
¦  +- Program.cs
¦  +- Tools/ProTools.cs            # MCPツールの定義 (ブリッジクライアント)
¦  +- Ipc/BridgeClient.cs          # 名前付きパイプクライアント
¦  +- Ipc/IpcModels.cs             # 共有IPC DTO
+- .mcp.json                       # VS Copilot用のMCPサーバーマニフェスト

ArcGIS Proアドイン

アドインは、ArcGIS Proの起動時に 名前付きパイプサーバー を起動します。以下のような操作を処理します。

• pro.getActiveMapName
• pro.listLayers
• pro.countFeatures
• pro.zoomToLayer

基本的な使用法

Module.cs の例 (サンプルではボタン内にあります)

protected override bool Initialize()
{
    _service = new ProBridgeService("ArcGisProBridgePipe");
    _service.Start();
    return true; // 初期化成功
}

protected override bool CanUnload()
{
    _service?.Dispose();
    return true;
}

ProBridgeService ハンドラーの例

case "pro.countFeatures":
{
    if (req.Args == null ||
        !req.Args.TryGetValue("layer", out string? layerName) ||
        string.IsNullOrWhiteSpace(layerName))
        return new(false, "arg 'layer' required", null);

    int count = await QueuedTask.Run(() =>
    {
        var fl = MapView.Active?.Map?.Layers
            .OfType<FeatureLayer>()
            .FirstOrDefault(l => l.Name.Equals(layerName, StringComparison.OrdinalIgnoreCase));
        if (fl == null) return 0;
        using var fc = fl.GetFeatureClass();
        return (int)fc.GetCount();
    });

    return new(true, null, new { count });
}

MCPサーバー (.NET 8)

MCPサーバーは、公式の ModelContextProtocol NuGetパッケージを使用しています。

高度な使用法

Program.cs

await Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddSingleton(new BridgeClient("ArcGisProBridgePipe"));
        services.AddMcpServer()
            .WithStdioServerTransport()
            .WithToolsFromAssembly(typeof(ProTools).Assembly);
    })
    .RunConsoleAsync();

ツールの例

[McpServerToolType]
public static class ProTools
{
    private static BridgeClient _client;
    public static void Configure(BridgeClient client) => _client = client;

    [McpServerTool(Title = "Count features in a layer", Name = "pro.countFeatures")]
    public static async Task<object> CountFeatures(string layer)
    {
        var r = await _client.OpAsync("pro.countFeatures", new() { ["layer"] = layer });
        if (!r.Ok) throw new Exception(r.Error);
        var count = ((System.Text.Json.JsonElement)r.Data).GetProperty("count").GetInt32();
        return new { layer, count };
    }
}

.mcp.json マニフェスト

ソリューションのルートに配置します (.mcp.json)。

{
  "servers": {
    "arcgis": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "McpServer/ArcGisMcpServer/ArcGisMcpServer.csproj"
      ]
    }
  }
}

Visual Studioでの実行

1. Visual Studio 2022 (=17.14) でソリューションを開きます。
2. ArcGIS Proがアドインを読み込んで実行されていることを確認します (名前付きパイプが存在する必要があります)。
3. VSで Copilot Chatエージェントモード を開きます。
4. Copilotが .mcp.json を読み取り、MCPサーバーを起動します。
5. チャットに以下を入力します。
   • pro.listLayers ? アクティブな地図のレイヤーを返します
   • pro.countFeatures layer=Buildings ? フィーチャーのカウント数を返します

📚 ドキュメント

次のステップ

• pro.selectByAttribute、pro.getCurrentExtent、pro.exportLayer などの操作でツールを拡張します。
• IPC通信のリトライ/タイムアウトロジックを追加します。
• MCPサーバーをコンテナ化してデプロイします。 ...