FIWARE MCP Server

This is a first implementation of a FIWARE Model Context Protocol (MCP) Server that provides a bridge between the Context Broker and other services. The server implements basic operations for interacting with a FIWARE Context Broker.

Objectives

• Create a basic MCP server implementation for FIWARE

• Provide simple tools for Context Broker interaction

• Demonstrate basic intent CRUD operations with the Context Broker

• Serve as a foundation for more complex MCP implementations

Related MCP server: Confluence MCP

Features

• Context Broker version checking

• Query capabilities for the Context Broker

• Entity publishing and updating

Prerequisites

• Python 3.7 or higher

• pip (Python package installer)

• Access to a FIWARE Context Broker instance

Installation

1. Clone this repository:

2. Install the required dependencies:

Claude Desktop integration

Usage

Start the MCP server:

The server will start on 127.0.0.1:5001 by default.

Available Tools

1. CB_version

   • Checks the version of the Context Broker

   • Default parameters: address="localhost", port=1026

   • Returns: JSON string with version information

2. query_CB

   • Queries the Context Broker

   • Parameters:

     • address (default: "localhost")

     • port (default: 1026)

     • query (default: "")

   • Returns: JSON string with query results

3. publish_to_CB

   • Publishes or updates entities in the Context Broker

   • Parameters:

     • address (default: "localhost")

     • port (default: 1026)

     • entity_data (required: dictionary with entity information)

   • Returns: JSON string with operation status

Example Usage

Configuration

The server can be configured by modifying the following parameters in server.py:

• Host address

• Port number

• Timeout settings

Error Handling

The server includes comprehensive error handling for:

• Network connectivity issues

• Invalid responses from the Context Broker

• Malformed entity data

• Server shutdown

Contributing

Feel free to submit issues and enhancement requests!

License

This project is licensed under the Apache License 2.0.