ADMIE Energy Data MCP Server

A Model Context Protocol (MCP) server providing access to Greek electricity market data from ADMIE (Independent Power Transmission Operator).

🚀 Features

• Real-time Data Access: Get electricity load, forecasts, and market data
• Intelligent Analysis: Built-in data parsing, statistics, and anomaly detection
• Forecast Accuracy: Compare predictions with actual consumption
• Market Intelligence: Generate comprehensive market summaries
• Claude Integration: Natural language queries for energy data

📋 Prerequisites

• Node.js 18.0.0 or higher
• Claude Desktop application
• Internet connection for ADMIE API access

🛠️ Installation

1. Install dependencies:

   cd "F:\MCP servers\admie-energy-data"
   npm install

2. Test the server:

   npm test

3. Configure Claude Desktop: Add to your ~/.claude_desktop_config.json:

   {
     "mcpServers": {
       "admie-energy-data": {
         "command": "node",
         "args": ["F:\\MCP servers\\admie-energy-data\\index.js"],
         "env": {
           "NODE_ENV": "production"
         }
       }
     }
   }

4. Restart Claude Desktop to load the MCP server

🔧 Available Tools

get_file_types

Get all available ADMIE file categories and descriptions.

Parameters:

• language (optional): 'all', 'gr', or 'en' for description language

get_market_files

Retrieve files for specific date range and category.

Parameters:

• dateStart: Start date (YYYY-MM-DD)
• dateEnd: End date (YYYY-MM-DD)
• fileCategory: File type (e.g., 'RealTimeSCADASystemLoad')
• useRange (optional): Use range search instead of exact match

download_file

Download and parse ADMIE data files.

Parameters:

• fileURL: Complete URL to the file
• parseContent (optional): Parse file content (default: true)
• maxRows (optional): Maximum rows to return (default: 1000)

analyze_load_forecast

Analyze load forecast data and generate insights.

Parameters:

• dateStart: Analysis start date
• dateEnd: Analysis end date
• forecastType: 'WeekAhead', 'DayAhead', or 'RealTime'

market_summary

Generate comprehensive market summary report.

Parameters:

• dateStart: Summary start date
• dateEnd: Summary end date
• includeForecasts (optional): Include forecast data
• includeRealTime (optional): Include real-time data
• detailed (optional): Include detailed analysis

compare_forecast_accuracy

Compare forecast accuracy with actual data.

Parameters:

• forecastDate: Date of forecast
• actualDate: Date of actual data
• forecastType: 'WeekAhead' or 'DayAhead'

💡 Usage Examples

With Claude Desktop

1. Get available data types:

   "What types of energy data are available from ADMIE?"

2. Analyze yesterday's consumption:

   "Using ADMIE data, analyze yesterday's electricity load patterns in Greece. Look for any unusual spikes or patterns."

3. Check forecast accuracy:

   "Compare last week's day-ahead load forecasts with actual consumption data. How accurate were the predictions?"

4. Generate market report:

   "Create a weekly energy market summary for Greece including load patterns, forecasts, and any notable events."

5. Real-time monitoring:

   "Get the latest real-time electricity consumption data and check for any anomalies."

Direct API Calls

// Example: Get today's load data
{
  "tool": "get_market_files",
  "arguments": {
    "dateStart": "2025-08-30",
    "dateEnd": "2025-08-30", 
    "fileCategory": "RealTimeSCADASystemLoad"
  }
}

// Example: Download and analyze a file
{
  "tool": "download_file",
  "arguments": {
    "fileURL": "https://www.admie.gr/path/to/file.csv",
    "parseContent": true,
    "maxRows": 500
  }
}

📊 Common File Categories

• RealTimeSCADASystemLoad: Real-time electricity consumption
• ISPDayAheadLoadForecast: Day-ahead load predictions
• ISPWeekAheadLoadForecast: Week-ahead load predictions
• ISPRequirements: System requirements and constraints

🔍 Data Analysis Features

The server automatically provides:

• Statistical Analysis: Min, max, average, median for numeric data
• Anomaly Detection: Identifies unusual patterns using statistical methods
• Trend Analysis: Determines if data is increasing, decreasing, or stable
• Forecast Accuracy: Calculates MAE, RMSE, MAPE, and correlation
• Data Insights: Automated insights and recommendations

🛡️ Error Handling

The server includes robust error handling for:

• Network timeouts and connection issues
• Invalid date formats and ranges
• Missing or malformed data files
• Parsing errors for different file formats

📈 Performance Considerations

• File Size Limits: Large files are automatically truncated
• Timeout Protection: 30-second timeout for downloads
• Memory Management: Efficient parsing for large datasets
• Caching: Results can be cached at the application level

🔧 Development

Running in Development Mode

npm run dev

Testing

npm test

Debugging

The server logs errors to stderr, which can be viewed in Claude Desktop's developer tools.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🆘 Troubleshooting

Common Issues

1. "Server not found"

   • Check that Node.js is installed and in PATH
   • Verify the file path in Claude Desktop config
   • Restart Claude Desktop after configuration changes

2. "Network timeout"

   • Check internet connection
   • ADMIE servers may be temporarily unavailable
   • Try different date ranges or file categories

3. "Parse error"

   • Some ADMIE files may have non-standard formats
   • Try with parseContent: false to get raw data
   • Check file category and date validity

Getting Help

• Check the Claude Desktop logs for detailed error messages
• Verify ADMIE API is accessible: https://www.admie.gr/getFiletypeInfo
• Test with recent dates (last 7-30 days)

🌐 Resources

• ADMIE Official Website
• ADMIE API Documentation
• Claude Desktop Documentation
• MCP Protocol

---

Ready to analyze Greek energy data with AI? Start asking Claude about electricity consumption patterns! ⚡