Ordnance Survey National Geographic Database

🚀 オーディナンス・サーベイ - MCP サーバ

Python ベースの MCP サーバで、オーディナンス・サーベイ API へのアクセスを提供します。このサーバを利用することで、地理データの照会が容易になり、複雑な OS 地理情報システムに標準プロトコルを通じて簡単にアクセスできます。

🚀 クイックスタート

このサービスは、MCP クライアントと OS API の間に橋渡しをし、地理データの照会を簡単にします。標準プロトコルを使用することで、複雑な OS 地理情報システムにアクセスできます。

✨ 主な機能

• 集合管理（リストとクエリ）
• 属性と空間フィルタリングによる特徴検索
• ID で特定の特徴を取得
• リンク識別子操作
• バルク特徴操作

📦 インストール

必要条件

• Python 3.11 以上のバージョン
• OS API キー（環境変数 OS_API_KEY として設定）
• オーディナンス・サーベイ データセンターのアカウントに登録し、API キーを取得する必要があります。
• 依存関係: 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"
      }
    }
  }
}

💻 使用例

基本的な使用法

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 での高度な使用方法について説明します。

1. Claude Desktop がローカルツールにアクセスできるように設定します。
2. サービスを起動すると、ツールとして使用できます。
3. 追加のネットワーク構成は必要ありません。

📚 ドキュメント

プロジェクト構造

• api_service - OS API へのアクセスに使用する非同期 HTTP クライアントの実装です。
  • 認証、リクエストのフォーマット、レスポンスの処理を担当します。
  • レート制限とエラー処理を管理します。
  • 外部 API エンドポイントにクリーンなインターフェースを提供します。
• mcp_service - OS API の機能を MCP ツールとして公開します。
  • API レスポンスを MCP 互換の形式に変換します。
  • ビジネスロジックの特徴操作を実装します。
  • 他のサービスに標準インターフェースを提供します。

利用可能なツール

現在、以下のツールが利用可能です（すべて開発中です）。

• 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 - 単一の呼び出しで複数の機能を取得します。
• get_bulk_linked_features - バルクでリンクされた機能を取得します。
• get_prompt_templates - 一般的な操作の標準プロンプトテンプレートを取得します。

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

このサービスは、事前に構成されたプロンプトテンプレートを提供し、すぐに使い始めることができます。これらのテンプレートにアクセスするには、Claude に「利用可能なプロンプトテンプレートを表示」と依頼してください。

🔧 技術詳細

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

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。ただし、このプロジェクトはオーディナンス・サーベイによって承認されていません。

貢献

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