READMEmain

MCP-TermoAlert-Bucharest

MCP-TermoAlert is a Model Context Protocol server that provides real-time information about thermal agent issues in Bucharest by parsing data from Termoenergetica's website. It allows AI assistants to access up-to-date information about heating system outages in different sectors of Bucharest.

Features

Fetches and parses thermal issue reports from Termoenergetica's official website
Provides structured data through MCP tools, making it accessible to AI assistants
Filters issues by sector or street name
Written in TypeScript for type safety and maintainability

Usage as MCP Server

This package is designed to be used as an MCP server with stdio transport, which can be connected to AI assistants like Claude or other MCP-compatible clients. When run, it starts an MCP server that listens for tool calls through stdin/stdout.

To start the server:

npx mcp-termoalert-bucharest

Usage in Claude Desktop

To use this package in Claude Desktop, you need to configure the claude_desktop_config.json file as follows:

{
  "mcpServers": {
    "central-heating-issues-bucharest": {
      "command": "npx",
      "args": ["-y", "mcp-termoalert-bucharest"]
    }
  }
}

This configuration allows Claude Desktop to call the MCP server for retrieving information about central heating issues in Bucharest.

Available MCP Tools

The server provides the following MCP tools:

`get_central_heating_issues`

Retrieves all current thermal issues across all sectors of Bucharest.

Parameters: None

Returns: JSON array of issue objects containing:

sector: The sector number (1-6)
zonesAffected: Array of affected locations
thermalAgent: Type of thermal agent affected
description: Description of the issue
estimatedRestart: Estimated date and time of service restoration

`get_central_heating_issues_for_sector`

Retrieves thermal issues for a specific sector in Bucharest.

Parameters:

sector: Number (1-6) representing the sector of Bucharest

Returns: JSON array of issue objects filtered by the specified sector

`get_central_heating_issues_for_street`

Retrieves thermal issues affecting a specific street.

Parameters:

street: String representing the street name (case-insensitive)

Returns: JSON array of issue objects where the affected zones include the specified street name

Data Structure

Each issue is represented as an object with the following structure:

interface Issue {
    sector: number;             // The sector number (1-6 for Bucharest)
    zonesAffected: string[];    // Array of affected zones
    thermalAgent: string;       // Type of thermal agent affected
    description: string;        // Description of the issue
    estimatedRestart: Date;     // Estimated date and time when service will be restored
}

Development

Prerequisites

Node.js v22 or higher
npm or yarn

Setting Up the Development Environment

Clone the repository:

git clone https://github.com/vaneavasco/mcp-termoalert.git
cd mcp-termoalert

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Scripts

npm run build: Compiles the TypeScript code to JavaScript and makes the index.js file executable.
npm run test: Runs the test suite using Jest.
npm run watch: Watches for changes and recompiles the code.
npm run run: Runs the main script using tsx.

Running Tests

Run the test suite with:

npm test

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

Developed by Vanea Vasco. `

mcp-termoalert