MCP Server Arcgis Pro Addin

🚀 帶有ArcGIS Pro插件的MCP服務器 (C# .NET 8)

本倉庫展示瞭如何將模型上下文協議（MCP）服務器與ArcGIS Pro插件集成。目標是將ArcGIS Pro的功能作為MCP工具公開，以便GitHub Copilot（代理模式）或任何MCP客戶端能夠與您的GIS環境進行交互。

🚀 快速開始

本項目可讓Copilot（代理模式）直接在ArcGIS Pro中查詢地圖、列出圖層、統計要素數量、縮放至圖層等。要使用該項目，需要完成以下步驟：

1. 確保滿足先決條件。
2. 瞭解解決方案結構。
3. 按照在Visual Studio中運行的步驟操作。

✨ 主要特性

• ArcGIS Pro插件（使用ArcGIS Pro SDK的C#）：與ArcGIS Pro 同進程運行，並通過本地IPC通道（命名管道）公開GIS操作。
• MCP服務器（.NET 8控制檯應用程序）：定義MCP工具，通過命名管道與插件通信，並通過.mcp.json在Visual Studio中配置為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請求/響應數據傳輸對象
+- ArcGisMcpServer/                # MCP服務器項目（.NET 8）
¦  +- Program.cs
¦  +- Tools/ProTools.cs            # MCP工具定義（橋接客戶端）
¦  +- Ipc/BridgeClient.cs          # 命名管道客戶端
¦  +- Ipc/IpcModels.cs             # 共享IPC數據傳輸對象
+- .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, "參數 'layer' 是必需的", 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 = "統計圖層中的要素數量", 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聊天代理模式。
4. Copilot讀取.mcp.json並啟動MCP服務器。
5. 在聊天中輸入：
   • pro.listLayers ？返回活動地圖中的圖層
   • pro.countFeatures layer=Buildings ？返回要素數量

📚 詳細文檔

下一步計劃

• 使用pro.selectByAttribute、pro.getCurrentExtent、pro.exportLayer等操作擴展工具。
• 為IPC通信添加重試/超時邏輯。
• 將MCP服務器容器化以進行部署。 ...