Картографическое управление - сервер MCP

MCP-сервер на базе Python, обеспечивающий доступ к API Ordnance Survey.

Обзор

Эта служба создает мост между клиентами MCP и API ОС, упрощая запрос географических данных через стандартизированный протокол.

Служба обеспечивает аутентификацию, (базовое) ограничение скорости и предоставляет упрощенный интерфейс для сложных API ОС.

Related MCP server: catastro_mcp_server

Структура проекта

• api_service — реализация асинхронного HTTP-клиента для API ОС

  • Выполняет аутентификацию, форматирование запросов и обработку ответов.

  • Управляет ограничением скорости и обработкой ошибок

  • Предоставляет понятный интерфейс для внешних конечных точек API.

• mcp_service — предоставляет функциональность API ОС в качестве инструментов MCP

  • Преобразует ответы API в форматы, совместимые с MCP

  • Реализует бизнес-логику для операций с функциями

  • Предоставляет стандартизированный интерфейс для других услуг

Функции

• Управление коллекциями (перечисление и запрос коллекций)

• Поиск объектов с использованием пространственных и атрибутивных фильтров

• Поиск индивидуальных характеристик по идентификатору

• Операции со связанными идентификаторами

• Массовые операции с функциями

Требования

• Питон 3.11+

• Ключ API ОС (задается как переменная среды OS_API_KEY )

• Вам необходимо зарегистрировать учетную запись OS Data Hub, чтобы получить ключ 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"
      }
    }
  }
}

Интеграция рабочего стола Клода

Эта служба 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 — Получить определенную функцию по идентификатору

• get_linked_identifiers — Найти связанные идентификаторы

• get_bulk_features — получение нескольких функций за один вызов

• get_bulk_linked_features — Массовое получение связанных функций

• get_prompt_templates — Получить стандартные шаблоны подсказок для распространенных операций

Использование шаблонов подсказок

Эта услуга предоставляет предварительно настроенные шаблоны подсказок, которые помогут вам начать работу.

Чтобы получить доступ к этим шаблонам, попросите Клода «показать мне доступные шаблоны подсказок».

Внося вклад

Вклады приветствуются! Пожалуйста, откройте тему или отправьте запрос на извлечение.

Лицензия

Данный проект лицензирован по лицензии MIT.

Данный проект не имеет одобрения Картографического управления.