FIWARE MCP 서버

이는 컨텍스트 브로커와 다른 서비스 간의 브리지 역할을 하는 FIWARE 모델 컨텍스트 프로토콜(MCP) 서버의 첫 번째 구현입니다. 이 서버는 FIWARE 컨텍스트 브로커와 상호 작용하기 위한 기본 작업을 구현합니다.

목표

FIWARE를 위한 기본 MCP 서버 구현을 만듭니다.
Context Broker 상호 작용을 위한 간단한 도구 제공
Context Broker를 사용하여 기본 의도 CRUD 작업을 시연합니다.
더욱 복잡한 MCP 구현을 위한 기반 역할을 합니다.

특징

Context Broker 버전 확인
Context Broker에 대한 쿼리 기능
엔티티 게시 및 업데이트

필수 조건

Python 3.7 이상
pip(Python 패키지 설치 프로그램)
FIWARE Context Broker 인스턴스에 대한 액세스

설치

이 저장소를 복제하세요:

지엑스피1

필요한 종속성을 설치하세요:

pip install -r requirements.txt

Claude Desktop 통합

mcp install server.py

# Custom name
mcp install server.py --name "FIWARE MCP Server"

# Environment variables, if any
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env

용법

MCP 서버를 시작합니다.

python server.py
# or
mcp run server.py

서버는 기본적으로 127.0.0.1:5001 에서 시작됩니다.

사용 가능한 도구

CB_버전
- Context Broker의 버전을 확인합니다.
- 기본 매개변수: address="localhost", port=1026
- 반환: 버전 정보가 포함된 JSON 문자열
쿼리_CB
- 컨텍스트 브로커에 쿼리합니다
- 매개변수:
  - 주소(기본값: "localhost")
  - 포트(기본값: 1026)
  - 쿼리(기본값: "")
- 반환: 쿼리 결과가 포함된 JSON 문자열
CB에 게시
- Context Broker에서 엔터티를 게시하거나 업데이트합니다.
- 매개변수:
  - 주소(기본값: "localhost")
  - 포트(기본값: 1026)
  - entity_data(필수: 엔티티 정보가 포함된 사전)
- 반환: 작업 상태가 포함된 JSON 문자열

사용 예

# Example entity data
entity_data = {
    "id": "urn:ngsi-ld:TemperatureSensor:001",
    "type": "TemperatureSensor",
    "temperature": {
        "type": "Property",
        "value": 25.5
    },
    "@context": "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
}

# Publish to Context Broker
result = publish_to_CB(entity_data=entity_data)

구성

다음 매개변수를 server.py 에서 수정하여 서버를 구성할 수 있습니다.

호스트 주소
포트 번호
시간 초과 설정

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

네트워크 연결 문제
Context Broker에서 잘못된 응답이 왔습니다.
잘못된 엔터티 데이터
서버 종료

기여하다

문제점과 개선 요청을 자유롭게 제출하세요!

특허

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

Integrations