Ordnance Survey - Servidor MCP

Un servidor MCP basado en Python que proporciona acceso a las API de Ordnance Survey.

Descripción general

Este servicio crea un puente entre los clientes MCP y las API del sistema operativo, lo que facilita la consulta de datos geográficos a través de un protocolo estandarizado.

El servicio maneja la autenticación, la limitación de velocidad (básica) y proporciona una interfaz simplificada para las API complejas del sistema operativo.

Estructura del proyecto

• api_service - Implementación de cliente HTTP asincrónico para las API del sistema operativo

  • Maneja la autenticación, el formato de la solicitud y el procesamiento de la respuesta.

  • Gestiona la limitación de velocidad y el manejo de errores.

  • Proporciona una interfaz limpia para los puntos finales de API externos

• mcp_service : expone la funcionalidad de las API del sistema operativo como herramientas MCP

  • Convierte las respuestas de API a formatos compatibles con MCP

  • Implementa lógica empresarial para operaciones de funciones

  • Proporciona una interfaz estandarizada para otros servicios.

Características

• Gestión de colecciones (enumeración y consulta de colecciones)

• Búsqueda de características con filtros espaciales y de atributos

• Recuperación de características individuales por ID

• Operaciones de identificadores vinculados

• Operaciones de características en masa

Requisitos

• Python 3.11+

• Clave API del sistema operativo (establecida como variable de entorno OS_API_KEY )

• Necesitará registrarse para obtener una cuenta de OS Data Hub para obtener una clave API

• Dependencias: aiohttp, mcp[cli]

Uso

Configure en su archivo de configuración de host MCP (por ejemplo, Claude Desktop):

Integración de escritorio de Claude

Este servicio MCP solo se ha probado con Claude Desktop.

El objetivo es hacer que este servicio funcione con varios hosts/clientes MCP, pero esto aún no se ha probado.

Al utilizar con Claude Desktop:

1. Asegúrese de que Claude Desktop esté configurado para acceder a herramientas locales

2. El servicio estará disponible como herramienta una vez que esté en funcionamiento.

3. No se necesita ninguna configuración de red adicional

Herramientas disponibles

Todo esto es un trabajo en progreso, pero las siguientes herramientas están disponibles:

• hello_world - Prueba de conectividad

• check_api_key - Verificar la configuración de la clave API

• list_collections - Lista de colecciones de características disponibles

• get_collection_info - Obtener detalles sobre una colección específica

• get_collection_queryables - Obtener propiedades filtrables para una colección

• search_features - Funciones de búsqueda según varios criterios

• get_feature - Recupera una característica específica por ID

• get_linked_identifiers - Encuentra identificadores relacionados

• get_bulk_features - Recupera múltiples funciones en una sola llamada

• get_bulk_linked_features - Obtener funciones vinculadas de forma masiva

• get_prompt_templates : obtiene plantillas de solicitud estándar para operaciones comunes

Uso de plantillas de indicaciones

Este servicio proporciona plantillas de indicaciones preconfiguradas para ayudarle a comenzar.

Para acceder a estas plantillas, pregúntele a Claude "muéstrame las plantillas de indicaciones disponibles".

Contribuyendo

¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Este proyecto no cuenta con el aval de Ordnance Survey.