Ordnance Survey MCP-Server

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.

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:

Stellen Sie sicher, dass Claude Desktop für den Zugriff auf lokale Tools konfiguriert ist.
Der Dienst wird als Tool verfügbar sein, sobald er läuft
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.

Ordnance Survey MCP Server