Zarejestruj serwer MCP przy użyciu pakietu MCP

W tym artykule omówiono proces rejestrowania serwera MCP przy użyciu pakietu MCP, który jest formatem ustandaryzowanym do wdrażania serwerów MCP. Aby uzyskać więcej informacji na temat tego formatu pakietu, zobacz MCP repozytorium GitHub pakietu, github.com/anthropics/mcpb/. Możesz dołączyć MCPB do istniejącej aplikacji systemu Windows lub rozpowszechnić MCPB samodzielnie.

Aplikacje pakowane w formacie MSIX mogą zawierać metadane, które automatycznie zarejestrują serwer MCP podczas instalacji pakietu. Aby uzyskać więcej informacji, zobacz Rejestrowanie MCP serwera z aplikacji przy użyciu tożsamości pakietu.

Ostrzeżenie

MCP serwery działają w sesji agenta, która uruchamiana jest na jego własnym koncie użytkownika. MCP pakiety nie są obsługiwane w sesji agenta i dlatego nie są domyślnie obsługiwane. Serwery zarejestrowane przy użyciu MCP pakietów nie będą dostępne z rejestru agentów urządzeń z systemem Windows. Dla celów testowych można włączyć MCP pakiety dla sesji agentowych. Aby uzyskać więcej informacji, w tym ważne zastrzeżenia dotyczące zabezpieczeń, zobacz Ograniczanie ochrony łączników agentów.

Uwaga / Notatka

Niektóre informacje odnoszą się do wstępnie wydanego produktu, który może zostać znacząco zmodyfikowany, zanim zostanie wydany komercyjnie. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do podanych tutaj informacji.

Wymagania wstępne

MCP Zainstaluj pakiet narzędziowy pakietu

Otwórz wiersz polecenia i zainstaluj pakiet NPM za pomocą tego polecenia:

dotnet tool install -g mcpb.cli

Stwórz swój MCP pakiet

Pakiet można zainicjować i skompilować, uruchamiając polecenie mcpb init i mcpb pack. Aby uzyskać więcej informacji, odwiedź repozytorium GitHub MCPB .NET CLI.

Możesz również użyć przykładu serwera w języku C#MCP, aby wygenerować MCP pakiet do przetestowania za pomocą następujących poleceń:

git clone https://github.com/microsoft/mcp-on-windows-samples.git
cd mcp-on-windows-samples
cd mcp-server-csharp
.\build-mcpb.ps1

Te polecenia spowodują utworzenie pliku o nazwie mcp-dotnet-mcpb-server.mcpb w folderze mcp-server-csharp .

Sekcja _meta pliku konfiguracji JSON MCPB

MCP w systemie Windows i rejestrze agentów urządzeń (ODR) wymagają włączenia _meta sekcji MCP schematu manifestu pakietu, który ma przechowywać opcjonalne rozszerzenia do schematu. ODR używa następujących właściwości zadeklarowanych w sekcji _meta manifestu, jako elementy podrzędne obiektu com.microsoft.windows.

Majątek Description
package_family_name Nazwa rodziny pakietów serwera. Wartość tej właściwości jest zawsze generowana przez ODR. Jeśli serwer udostępnia je podczas rejestrowania, są one ignorowane.
odpowiedzi_statyczne Zarejestrowany MCP serwer musi zawierać tę sekcję, która zawiera listę wszystkich funkcji i narzędzi udostępnianych przez serwer. Ta lista jest dokładnie zgodna z listą odpowiedzi środowiska uruchomieniowego. Dzięki temu ODR może zweryfikować, że w czasie wykonywania udostępniane są tylko oczekiwane narzędzia i możliwości, a także umożliwia wyszukiwanie narzędzi dla MCP hostów bez konieczności uruchamiania serwera MCP, co może generować monity o wyrażenie zgody i powiązane koszty wydajnościowe.

Ważne

Jeśli chcesz, aby serwer MCP działał w trybie domyślnym, wartości zwracane przez implementację serwera muszą być zgodne z wartościami zadeklarowanymi w pliku MCPB.

Oto kilka przykładów wartości w pliku MCPB, które muszą być zgodne z wartościami zwróconymi przez implementację serwera:

  • Właściwości name najwyższego poziomu oraz właściwości wersji muszą być zgodne z właściwościami name i version w serverInfo, w sekcji inicjowania.
  • Element najwyższego poziomu tools musi znajdować się w bogatszym schemacie tools/list.
  • Serwer nie może dynamicznie zmieniać zestawu narzędzi, ich opisów ani schematów wejściowych lub wyjściowych.
  • Serwery initialize i tools/list środowisko uruchomieniowe muszą być zgodne z tym, co znajduje się w manifeście.

Jeśli zaktualizujesz dowolną z tych wartości na serwerze, musisz zaktualizować plik konfiguracji MCPB, aby był zgodny z nowymi wartościami lub MCP serwer nie będzie już działać w trybie domyślnym. Interfejs wiersza polecenia CLI platformy .NET MCPB może być używany do tworzenia i weryfikowania prawidłowych pól _meta dla serwera.

Poniżej przedstawiono przykładową sekcję _meta z pliku konfiguracji MCPB.

{
  "_meta": {
    "com.microsoft.windows": {
      "static_responses": {
        "initialize": {
          "protocolVersion": "2025-06-18",
          "capabilities": {
            "logging": {},
            "tools": {
              "listChanged": true
            }
          },
          "serverInfo": {
            "name": "ProductStockSystem.McpServer",
            "version": "1.0.0.0"
          }
        },
        "tools/list": {
          "tools": [
            {
              "name": "list_products",
              "description": "Get a list of all active products in the stock system",
              "inputSchema": {
                "type": "object",
                "properties": {}
              },
              "outputSchema": {
                "type": "object",
                "properties": {
                  "products": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "name": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        },
                        "sku": {
                          "type": "string"
                        },
                        "price": {
                          "type": "number"
                        },
                        "stockQuantity": {
                          "type": "integer"
                        },
                        "reorderLevel": {
                          "type": "integer"
                        },
                        "isLowStock": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "description",
                        "sku",
                        "price",
                        "stockQuantity",
                        "reorderLevel",
                        "isLowStock"
                      ]
                    }
                  },
                  "count": {
                    "type": "integer"
                  },
                  "success": {
                    "type": "boolean"
                  },
                  "error": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "products",
                  "count",
                  "success"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Rozpowszechniaj plik .mcpb lub dołącz go do swojej aplikacji.

Plik można dystrybuować bezpośrednio, w stanie nienaruszonym, aby dostarczyć samodzielny serwer , lub można go zintegrować w ramach aplikacji, uruchamiając plik pakietowy podczas instalacji aplikacji.

Przetestuj swój MCP serwer

Teraz możesz sprawdzić, czy twój MCP serwer poprawnie się wyświetla jako część standardowej instalacji aplikacji, poprzez zainstalowanie aplikacji, a następnie korzystając z przewodnika testowania, aby się z nim połączyć. Aby uzyskać więcej informacji, zobacz Testowanie MCP serwerów w systemie Windows.

Dalsze kroki

  • Dowiedz się o funkcjach sesji agenta w MCP dla systemu Windows i zrozum, dlaczego warto przenieść swoją aplikację na MSIX i wykorzystać tożsamość pakietu, aby korzystać z sesji agenta. Aby uzyskać więcej informacji, zobacz Bezpieczna izolacja MCP serwerów w systemie Windows.
  • Last updated on