Ordnance Survey MCP Server

Ordnance Survey - MCP 서버

Ordnance Survey API에 대한 액세스를 제공하는 Python 기반 MCP 서버입니다.

개요

이 서비스는 MCP 클라이언트와 OS API 사이에 브리지를 만들어 표준화된 프로토콜을 통해 지리적 데이터를 쉽게 쿼리할 수 있도록 해줍니다.

이 서비스는 인증, (기본) 속도 제한을 처리하고 복잡한 OS API에 대한 간소화된 인터페이스를 제공합니다.

프로젝트 구조

• api_service - OS API를 위한 비동기 HTTP 클라이언트 구현
  • 인증, 요청 형식 지정 및 응답 처리를 처리합니다.
  • 속도 제한 및 오류 처리를 관리합니다.
  • 외부 API 엔드포인트에 대한 깔끔한 인터페이스를 제공합니다.
• mcp_service - OS API 기능을 MCP 도구로 노출합니다.
  • API 응답을 MCP 호환 형식으로 변환합니다.
  • 기능 작업을 위한 비즈니스 로직을 구현합니다.
  • 다른 서비스에 대한 표준화된 인터페이스를 제공합니다.

특징

• 컬렉션 관리(컬렉션 목록 및 쿼리)
• 공간 및 속성 필터를 사용한 피처 검색
• ID별 개별 기능 검색
• 연결된 식별자 작업
• 대량 기능 작업

요구 사항

• 파이썬 3.11+
• OS API 키(환경 변수 OS_API_KEY 로 설정)
• API 키를 받으려면 OS Data Hub 계정에 등록해야 합니다.
• 종속성: aiohttp, mcp[cli]

용법

MCP 호스트 구성 파일(예: Claude Desktop)에서 다음을 구성합니다.

지엑스피1

Claude 데스크톱 통합

이 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 - 단일 호출에서 여러 기능 검색
• get_bulk_linked_features - 대량으로 연결된 기능 가져오기
• get_prompt_templates - 일반적인 작업에 대한 표준 프롬프트 템플릿을 가져옵니다.

프롬프트 템플릿 사용

이 서비스는 시작하는 데 도움이 되는 미리 구성된 프롬프트 템플릿을 제공합니다.

이러한 템플릿에 액세스하려면 Claude에게 "사용 가능한 프롬프트 템플릿을 보여주세요"라고 요청하세요.

기여하다

기여를 환영합니다! 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

이 프로젝트는 영국 측량부의 승인을 받지 않았습니다.