Udostępnij za pośrednictwem

Zarejestruj i odkryj zdalne serwery MCP w inwentaryzacji API

W tym artykule opisano, jak używać Centrum interfejsów API platformy Azure do obsługi spisu (lub rejestru) serwerów zdalnego protokołu kontekstowego modelu (MCP) i pomóc uczestnikom projektu odnajdywać je za pomocą portalu Centrum interfejsu API. Serwery MCP udostępniają interfejsy API zaplecza lub źródła danych w standardowy sposób agentom i modelom sztucznej inteligencji korzystającym z nich.

Informacje o serwerach MCP

Agenci sztucznej inteligencji stają się coraz powszechnie stosowane z powodu rozszerzonych możliwości modelu języka (LLM). Jednak nawet najbardziej zaawansowane modele stoją w obliczu ograniczeń ze względu na ich izolację od danych zewnętrznych. Każde nowe źródło danych potencjalnie wymaga niestandardowych implementacji w celu wyodrębnienia, przygotowania i udostępnienia danych dla modeli.

Protokół kontekstu modelu (MCP) pomaga rozwiązać ten problem. MCP to otwarty standard łączenia modeli sztucznej inteligencji i agentów z zewnętrznymi źródłami danych, takimi jak lokalne źródła danych (bazy danych lub pliki komputerów) lub usługi zdalne (systemy dostępne za pośrednictwem Internetu, takie jak zdalne bazy danych lub interfejsy API).

Architektura MCP

Na poniższym diagramie przedstawiono architekturę MCP:

Diagram architektury protokołu kontekstowego modelu (MCP).

Niniejsza architektura zawiera następujące składniki:

Składnik Opis
Hosty MCP Aplikacje oparte na LLM, takie jak aplikacje czatu lub asystenci AI w IDE (np. GitHub Copilot w Visual Studio Code), które potrzebują dostępu do zewnętrznych funkcji
Klienci MCP Klienci protokołu wewnątrz aplikacji hosta, którzy utrzymują połączenia 1:1 z serwerami
Serwery MCP Lekkie programy, które udostępniają określone możliwości, zapewniają kontekst, narzędzia i monity klientom.
Protokół MCP Warstwa transportowa w środku

Program MCP jest zgodny z architekturą klient-serwer, w której aplikacja hosta może łączyć się z wieloma serwerami. Za każdym razem, gdy host MCP lub klient potrzebuje narzędzia, nawiązuje połączenie z serwerem MCP. Następnie serwer MCP nawiązuje połączenie z bazą danych lub interfejsem API. Hosty i serwery MCP łączą się ze sobą za pośrednictwem protokołu MCP.

Zdalne a lokalne serwery MCP

McP korzysta z architektury client-host-server opartej na JSON-RPC 2.0 na potrzeby obsługi komunikatów. Komunikacja między klientami i serwerami odbywa się za pośrednictwem zdefiniowanych warstw transportu i obsługuje przede wszystkim dwa tryby działania:

  • Zdalne serwery MCP — klienci MCP łączą się z serwerami MCP przez Internet, ustanawiają połączenie przy użyciu HTTP i zdarzeń z serwera (SSE), a także autoryzują dostęp klienta MCP do zasobów na koncie użytkownika przy użyciu OAuth.

  • Lokalne serwery MCP Klienci MCP łączą się z serwerami MCP na tym samym komputerze przy użyciu standardowych danych wejściowych/wyjściowych jako lokalnej metody transportu.

Serwery MCP w zestawieniu API

W poniższych sekcjach opisano sposób tworzenia spisu i odnajdywania zdalnego serwera MCP w Centrum interfejsu API.

Typ interfejsu API MCP

Aby zarejestrować serwer MCP w spisie centrum interfejsu API, określ typ interfejsu API jako MCP. Aby zarejestrować interfejs API przy użyciu witryny Azure Portal, zobacz Samouczek: rejestrowanie interfejsów API w spisie interfejsów API.

Zgodnie z opisem w poniższych sekcjach podczas rejestrowania serwera MCP można określić środowisko, wdrożenie i definicję.

Środowisko i wdrażanie serwera MCP

W centrum interfejsu API określ środowisko i wdrożenie serwera MCP. Środowisko to lokalizacja serwera MCP, takiego jak platforma zarządzania API lub usługa obliczeniowa, a wdrożenie to adres URL uruchomieniowy dla usługi MCP.

Aby uzyskać informacje na temat tworzenia środowiska i wdrożenia, zobacz Samouczek: dodawanie środowisk i wdrożeń dla interfejsów API.

Definicja zdalnego serwera MCP

Opcjonalnie dodaj definicję interfejsu API dla zdalnego serwera MCP w formacie OpenAPI 3.0. Definicja interfejsu API musi zawierać punkt końcowy adresu URL dla serwera MCP. Aby zapoznać się z przykładem dodawania definicji interfejsu OpenAPI, zobacz Samouczek: rejestrowanie interfejsów API w spisie interfejsów API.

Można użyć następującej lekkiej definicji API OpenAPI 3.0 dla serwera MCP, która zawiera punkt dostępu url serwera MCP.

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

Odkrywanie serwerów MCP przy użyciu portalu Centrum API

Skonfiguruj portal Centrum interfejsów API , aby deweloperzy i inni uczestnicy projektu w organizacji mogli odnajdywać serwery MCP w spisie interfejsów API. Użytkownicy mogą przeglądać i filtrować serwery MCP w spisie i wyświetlać szczegóły, takie jak punkt końcowy adresu URL serwera MCP, jeśli jest dostępny w definicji interfejsu API serwera MCP.

Zrzut ekranu przedstawiający serwer MCP w portalu centrum interfejsu API.

Uwaga / Notatka

Punkt końcowy adresu URL serwera MCP jest widoczny tylko w portalu Centrum interfejsu API, jeśli dodasz wdrożenie MCP i definicję interfejsu API dla serwera MCP.

Treści powiązane