Dncampo FIWARE MCP Server

🚀 FIWARE MCP Server

This is the first implementation version of the FIWARE Model Context Protocol (MCP) server, which provides a bridge between the context broker and other services. The server implements basic operations for interacting with the FIWARE context broker.

🚀 Quick Start

This README provides a guide on how to install, configure, and use the FIWARE MCP Server. It also details the server's features, requirements, and contribution guidelines.

✨ Features

• Check the version of the context broker.
• Query the capabilities of the context broker.
• Publish and update entities.

📦 Installation

Prerequisites

• Python 3.7 or higher
• pip (Python package installer)
• Access to a FIWARE context broker instance

Steps

1. Clone this repository:

git clone <repository-url>
cd FIWARE_MCP_01

2. Install the required dependencies:

pip install -r requirements.txt

Claude Desktop Integration

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

💻 Usage Examples

Basic Usage

Start the MCP server:

python server.py
# Or
mcp run server.py

The server will start on 127.0.0.1:5001 by default.

Available Tools

1. CB_version

   • Check the version of the context broker.
   • Default parameters: address="localhost", port=1026
   • Returns: A JSON string containing version information.

2. query_CB

   • Query the context broker.
   • Parameters:
     • address (default: "localhost")
     • port (default: 1026)
     • query (default: "")
   • Returns: A JSON string of the query result.

3. publish_to_CB

   • Publish or update an entity in the context broker.
   • Parameters:
     • address (default: "localhost")
     • port (default: 1026)
     • entity_data (required: a dictionary containing entity information)
   • Returns: A JSON string of the operation status.

Advanced Usage

# 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 the context broker
result = publish_to_CB(entity_data=entity_data)

📚 Documentation

Configuration

You can configure the server by modifying the following parameters in server.py:

• Host address
• Port number
• Timeout settings

Error Handling

The server includes comprehensive error handling, including:

• Network connection issues
• Valid responses returned by the context broker
• Malformed entity data
• Server shutdown

📄 License

This project is licensed under the Apache License 2.0.

🔗 Badges

🎯 Goals

• Create a basic implementation of the FIWATE MCP server.
• Provide simple tools for context broker interaction.
• Demonstrate basic CRUD operations for the context broker.
• Serve as a foundation for a more complex MCP implementation.

🤝 Contribution

Feel free to submit issues and improvement requests!