FIWARE MCP 서버

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

목표

• FIWARE를 위한 기본 MCP 서버 구현을 만듭니다.

• Context Broker 상호 작용을 위한 간단한 도구 제공

• Context Broker를 사용하여 기본 의도 CRUD 작업을 시연합니다.

• 더욱 복잡한 MCP 구현을 위한 기반 역할을 합니다.

Related MCP server: Synapse MCP Server

특징

• Context Broker 버전 확인

• Context Broker에 대한 쿼리 기능

• 엔티티 게시 및 업데이트

필수 조건

• Python 3.7 이상

• pip(Python 패키지 설치 프로그램)

• FIWARE Context Broker 인스턴스에 대한 액세스

설치

1. 이 저장소를 복제하세요:

지엑스피1

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

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 에서 시작됩니다.

사용 가능한 도구

1. CB_버전

   • Context Broker의 버전을 확인합니다.

   • 기본 매개변수: address="localhost", port=1026

   • 반환: 버전 정보가 포함된 JSON 문자열

2. 쿼리_CB

   • 컨텍스트 브로커에 쿼리합니다

   • 매개변수:

     • 주소(기본값: "localhost")

     • 포트(기본값: 1026)

     • 쿼리(기본값: "")

   • 반환: 쿼리 결과가 포함된 JSON 문자열

3. 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에 따라 라이선스가 부여되었습니다.