陸地測量局 - MCP サーバー

Ordnance Survey API へのアクセスを提供する Python ベースの MCP サーバー。

概要

このサービスは、MCP クライアントと OS API の間にブリッジを作成し、標準化されたプロトコルを通じて地理データを簡単に照会できるようにします。

このサービスは認証、(基本的な)レート制限を処理し、複雑な OS API への簡素化されたインターフェースを提供します。

Related MCP server: Lodestar MCP Server

プロジェクト構造

• api_service - OS API 用の非同期 HTTP クライアント実装

  • 認証、リクエストのフォーマット、レスポンスの処理を行います

  • レート制限とエラー処理を管理する

  • 外部APIエンドポイントへのクリーンなインターフェースを提供します

• mcp_service - OS API 機能を MCP ツールとして公開します

  • API レスポンスを MCP 互換形式に変換します

  • 機能操作のビジネスロジックを実装する

  • 他のサービスのための標準化されたインターフェースを提供する

特徴

• コレクション管理（コレクションの一覧表示とクエリ）

• 空間フィルターと属性フィルターを使用したフィーチャ検索

• IDによる個別特徴検索

• リンクされた識別子の操作

• 一括機能操作

要件

• Python 3.11以上

• OS API キー (環境変数OS_API_KEYとして設定)

• APIキーを取得するには、OS Data Hubアカウントに登録する必要があります。

• 依存関係: aiohttp、mcp[cli]

使用法

MCP ホスト構成ファイル (例: 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"
      }
    }
  }
}

クロードデスクトップ統合

この MCP サービスは、Claude Desktop でのみテストされています。

このサービスをさまざまな MCP ホスト/クライアントで動作させることが目的ですが、まだテストされていません。

Claude Desktop と併用する場合:

1. Claude Desktopがローカルツールにアクセスできるように設定されていることを確認する

2. サービスは稼働後すぐにツールとして利用可能になります

3. 追加のネットワーク設定は必要ありません

利用可能なツール

これらはすべて進行中の作業ですが、次のツールが利用可能です。

• hello_world - 接続性をテストする

• check_api_key - APIキーの設定を確認する

• list_collections - 利用可能なフィーチャコレクションを一覧表示する

• get_collection_info - 特定のコレクションの詳細を取得する

• get_collection_queryables - コレクションのフィルター可能なプロパティを取得する

• search_features - さまざまな基準でフィーチャを検索

• get_feature - IDで特定のフィーチャを取得する

• get_linked_identifiers - 関連する識別子を見つける

• get_bulk_features - 1回の呼び出しで複数の特徴量を取得する

• get_bulk_linked_features - リンクされたフィーチャを一括取得する

• get_prompt_templates - 一般的な操作の標準プロンプトテンプレートを取得します

プロンプトテンプレートの使用

このサービスでは、開始するのに役立つ、事前構成されたプロンプト テンプレートが提供されます。

これらのテンプレートにアクセスするには、Claude に「利用可能なプロンプトテンプレートを表示」と尋ねてください。

貢献

貢献を歓迎します！問題を報告したり、プルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

このプロジェクトはOrdnance Surveyの承認を受けていません。