Nefino MCP Server

The Nefino MCP Server is a Model Context Protocol (MCP) server that provides Large Language Models (LLMs) with access to news and information about renewable energy projects, planning, and announcements in Germany. It integrates with the Nefino API to provide structured access to this data.

Features

• Retrieve news items for specific geographic locations
• Filter by various renewable energy topics (solar, wind, hydrogen, etc.)
• Support for both date range and recency-based queries
• Secure authentication through environment variables
• Input validation and error handling
• Full MCP compatibility

Installation

Prerequisites

• Python 3.10 or higher
• Access to the Nefino API (credentials required)

Installation

pip install git+https://github.com/nefino/mcp-nefino.git

Configuration

The server requires several environment variables to be set. They should be passed in directly when running the server.

NEFINO_USERNAME=your_username
NEFINO_PASSWORD=your_password
NEFINO_JWT_SECRET=your_jwt_secret
NEFINO_BASE_URL=http://api_endpoint

Usage

With Claude Desktop

1. Install Claude Desktop

2. Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "nefino": {
      "command": "python",
      "args": ["-m", "mcp_nefino"],
      "env": {
        "NEFINO_USERNAME": "your_username",
        "NEFINO_PASSWORD": "your_password",
        "NEFINO_JWT_SECRET": "your_jwt_secret",
        "NEFINO_BASE_URL": "http://api_endpoint"
      }
    }
  }
}

3. Restart Claude Desktop

Direct Usage

You can also run the server directly:

python -m mcp_nefino

Available Tools

retrieve_news_items_for_place

Retrieves news items for a specific location with various filtering options.

Parameters:

• place_id (string): The ID of the place
• place_type (enum): Type of place (PR, CTY, AU, LAU)
• range_or_recency (enum, optional): RANGE or RECENCY
• last_n_days (integer, optional): Number of days to look back (for RECENCY mode)
• date_range_begin (string, optional): Start date in YYYY-MM-DD format (for RANGE mode)
• date_range_end (string, optional): End date in YYYY-MM-DD format (for RANGE mode)
• news_topics (list of enums, optional): Topics to filter by (BATTERY_STORAGE, GRID_EXPANSION, SOLAR, HYDROGEN, WIND)

Example query via Claude:

Get renewable energy news for administrative unit DE9_AU0213 from January to June 2024, focusing on solar projects.

Development

To run in development mode with the MCP Inspector:

mcp dev -m mcp_nefino

Error Handling

The server performs validation on:

• Date formats (YYYY-MM-DD)
• Date range validity
• Parameter combinations for RANGE vs RECENCY modes
• API credentials and connectivity
• News topic validity

All errors are returned with descriptive messages to help diagnose issues.

License

[License type - e.g., MIT] - see LICENSE file for details