Ordnance Survey – MCP-Server

Ein Python-basierter MCP-Server, der Zugriff auf die Ordnance Survey-APIs bietet.

Überblick

Dieser Dienst stellt eine Brücke zwischen MCP-Clients und den OS-APIs her und erleichtert die Abfrage geografischer Daten über ein standardisiertes Protokoll.

Der Dienst übernimmt die Authentifizierung, (grundlegende) Ratenbegrenzung und bietet eine vereinfachte Schnittstelle zu komplexen OS-APIs.

Related MCP server: catastro_mcp_server

Projektstruktur

• api_service – Asynchrone HTTP-Client-Implementierung für die OS-APIs

  • Behandelt Authentifizierung, Anforderungsformatierung und Antwortverarbeitung

  • Verwaltet Ratenbegrenzung und Fehlerbehandlung

  • Bietet eine saubere Schnittstelle zu den externen API-Endpunkten

• mcp_service – Stellt die Funktionalität der OS-APIs als MCP-Tools bereit

  • Konvertiert API-Antworten in MCP-kompatible Formate

  • Implementiert Geschäftslogik für Feature-Operationen

  • Bietet eine standardisierte Schnittstelle für andere Dienste

Merkmale

• Sammlungsverwaltung (Auflisten und Abfragen von Sammlungen)

• Feature-Suche mit räumlichen und Attributfiltern

• Abruf einzelner Features nach ID

• Verknüpfte Kennungsvorgänge

• Massenfunktionsvorgänge

Anforderungen

• Python 3.11+

• OS-API-Schlüssel (als Umgebungsvariable OS_API_KEY festgelegt)

• Sie müssen sich für ein OS Data Hub-Konto registrieren, um einen API-Schlüssel zu erhalten

• Abhängigkeiten: aiohttp, mcp[cli]

Verwendung

Konfigurieren Sie in Ihrer MCP-Host-Konfigurationsdatei (z. B. Claude Desktop):

{
  "mcpServers": {
    "os-ngd-api": {
      "command": "/Users/username/.local/bin/uv",
      "args": ["--directory", "src/", "run", "server.py"],
      "env": {
        "OS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop Integration

Dieser MCP-Dienst wurde nur mit Claude Desktop getestet.

Das Ziel besteht darin, diesen Dienst mit verschiedenen MCP-Hosts/Clients kompatibel zu machen, dies wurde jedoch noch nicht getestet.

Bei Verwendung mit Claude Desktop:

1. Stellen Sie sicher, dass Claude Desktop für den Zugriff auf lokale Tools konfiguriert ist.

2. Der Dienst wird als Tool verfügbar sein, sobald er läuft

3. Es ist keine zusätzliche Netzwerkkonfiguration erforderlich

Verfügbare Tools

All dies ist noch in Arbeit, aber die folgenden Tools sind verfügbar:

• hello_world - Konnektivität testen

• check_api_key - API-Schlüsselkonfiguration überprüfen

• list_collections – Listet verfügbare Feature-Sammlungen auf

• get_collection_info - Details zu einer bestimmten Sammlung abrufen

• get_collection_queryables - Filterbare Eigenschaften für eine Sammlung abrufen

• search_features - Suche nach Features nach verschiedenen Kriterien

• get_feature - Ruft ein bestimmtes Feature anhand der ID ab

• get_linked_identifiers - Verwandte Kennungen finden

• get_bulk_features - Mehrere Features in einem einzigen Aufruf abrufen

• get_bulk_linked_features - Verknüpfte Features in großen Mengen abrufen

• get_prompt_templates - Standard-Eingabeaufforderungsvorlagen für allgemeine Vorgänge abrufen

Verwenden von Eingabeaufforderungsvorlagen

Dieser Dienst bietet vorkonfigurierte Eingabeaufforderungsvorlagen, die Ihnen den Einstieg erleichtern.

Um auf diese Vorlagen zuzugreifen, fragen Sie Claude: „Zeigen Sie mir verfügbare Eingabeaufforderungsvorlagen“

Beitragen

Beiträge sind willkommen! Bitte melden Sie ein Problem oder senden Sie einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Dieses Projekt verfügt nicht über die Genehmigung von Ordnance Survey.