FIWARE MCP Server

by dncampo

Integrations

  • Supports loading environment variables from .env files to configure the MCP server settings and Context Broker connection details

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

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:
git clone <repository-url> cd FIWARE_MCP_01
  1. 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

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
    • 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

# 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)

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A bridge between the Context Broker and other services, implementing basic operations for entity publishing, updating, and querying in FIWARE environments.

  1. Objectives
    1. Features
      1. Prerequisites
        1. Installation
          1. Claude Desktop integration
            1. Usage
              1. Available Tools
              2. Example Usage
            2. Configuration
              1. Error Handling
                1. Contributing
                  1. License

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
                      Last updated -
                      95
                      Python
                      MIT License
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
                      Last updated -
                      1
                      TypeScript
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server for MarkLogic that enables CRUD operations and document querying capabilities through a client interface.
                      Last updated -
                      Python
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server for accessing Confluence API using Personal Access Tokens, enabling users to retrieve space lists, view pages, create new pages, and update existing content.
                      Last updated -
                      TypeScript

                    View all related MCP servers

                    ID: y2m7ax73b4