Ordnance Survey National Geographic Database

🚀 軍械測量局 - MCP 服務器

這是一個基於 Python 的 MCP 服務器，為用戶提供對軍械測量局（Ordnance Survey）API 的便捷訪問，讓地理數據查詢變得輕而易舉。

🚀 快速開始

要求

• 需安裝 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 集成

此 MCP 服務僅在 Claude Desktop 上進行了測試，目標是使其與各種 MCP 主機/客戶端兼容，但尚未進行測試。使用時請按以下步驟操作：

1. 確保 Claude Desktop 配置為訪問本地工具。
2. 服務運行後即可作為工具使用。
3. 不需要額外的網絡配置。

✨ 主要特性

• 集合管理：支持集合的列表和查詢操作。
• 特徵搜索：可通過屬性和空間過濾進行特徵搜索。
• 特定特徵獲取：按 ID 獲取特定特徵。
• 鏈接標識符操作：進行鏈接標識符的相關操作。
• 批量特徵操作：支持批量獲取特徵和批量獲取鏈接功能。

📦 安裝指南

按照上述“要求”部分安裝所需的 Python 版本、獲取 API 密鑰並安裝依賴項，再進行配置文件的設置即可完成安裝。

💻 使用示例

基礎用法

以下是使用 hello_world 工具測試連接性的示例：

# 假設調用 hello_world 工具的代碼
# 這裡只是示例，實際代碼可能需要根據具體實現調整
result = call_hello_world()
print(result)

高級用法

使用 search_features 工具搜索符合特定條件的功能：

# 假設調用 search_features 工具的代碼
# 這裡只是示例，實際代碼可能需要根據具體實現調整
conditions = {
    "attribute": "value",
    "spatial": "condition"
}
result = search_features(conditions)
print(result)

📚 詳細文檔

項目結構

• api_service：異步 HTTP 客戶端實現，用於訪問 OS API。
  • 負責身份驗證、請求格式化和響應處理。
  • 管理速率限制和錯誤處理。
  • 為外部 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 "顯示可用提示模板"。

🔧 技術細節

此服務在 MCP 客戶端與 OS API 之間架起橋樑，使查詢地理數據變得簡單。通過標準協議即可輕鬆訪問複雜的 OS 地理信息系統。該服務處理身份驗證、（基本）速率限制，併為複雜 OS API 提供簡化的接口。

🤝 貢獻

歡迎貢獻！請打開問題或提交拉取請求。

📄 許可證

該項目在 MIT License 下授權。該項目未獲得軍械測量局的認可。