README - Valencia Smart City MCP Server by sosanzma

Valencia Smart City MCP Server

MCP server providing real-time traffic, bike-sharing, air quality and weather data from Valencia, Spain for Claude and other LLMs.

Real-time traffic conditions across Valencia
Valenbisi bike station availability
Air quality monitoring data from city stations
Weather data from Open-Meteo API (current, forecast, and historical)
Traffic congestion analysis
Search capabilities for specific roads, bike stations, or air quality information

Check out a live demos of this MCP in action with Claude Desktop :

This shared conversation demonstrates how Claude can access and analyze real-time Valencia urban data through the MCP.

# Clone the repository
git clone https://github.com/sosanzma/SmartCityMCP.git
cd SmartCityMCP

# Install dependencies
pip install -r requirements.txt

The server exposes these tools:

get_traffic_status
- Get current traffic status for road segments
- Input: state_filter (optional, integer[]) - Filter by traffic state codes
- Returns: List of road segments with their traffic states
get_congestion_summary
- Get summary of current traffic congestion in Valencia
- Returns: Statistics including congested segments and percentages
search_road_segment
- Search for specific road segments by name
- Input: name_query (string) - Case-insensitive search term
- Returns: List of matching road segments with current state

find_available_bikes
- Find bike stations with available bikes
- Inputs:
  - min_bikes (integer, default: 1) - Minimum number required
  - near_address (string, optional) - Address to search near
- Returns: List of stations matching criteria with availability info
get_bike_station_status
- Get detailed status of bike stations
- Input: station_id (string, optional) - For specific station
- Returns: Detailed status including bikes available and free slots

get_air_quality_summary
- Get overview of air quality across Valencia
- Returns: Summary statistics of pollutant levels and air quality ratings
find_nearest_air_station
- Find closest air quality monitoring station to coordinates
- Inputs:
  - latitude (float) - Latitude coordinate
  - longitude (float) - Longitude coordinate
- Returns: Nearest station details with distance and current readings
get_station_data
- Get detailed information about air quality monitoring stations
- Input: station_name (string) - Name to search for (partial match)
- Returns: Detailed pollutant data for matching stations
get_pollutant_levels
- Get levels of a specific pollutant across all stations
- Input: pollutant (string) - Pollutant type (so2, no2, o3, co, pm10, pm25)
- Returns: Measurements of specified pollutant with statistics
get_air_quality_map
- Get geospatial data of air quality stations for mapping
- Returns: Location data with quality ratings and pollutant levels

get_current_weather
- Get current weather conditions in Valencia
- Returns: Current weather data including temperature, humidity, wind speed, and weather description
get_weather_forecast
- Get weather forecast for Valencia
- Input: days (integer, default: 3) - Number of days to forecast (1-7)
- Returns: Hourly weather forecasts for the requested period
get_historical_weather
- Get historical weather data for Valencia
- Inputs:
  - start_date (string) - Start date in YYYY-MM-DD format
  - end_date (string) - End date in YYYY-MM-DD format
- Returns: Historical weather data for the specified period
get_daily_weather_summary
- Get daily weather summary for Valencia
- Input: day_offset (integer, default: 0) - Day offset (0=today, 1=tomorrow, etc.)
- Returns: Daily weather summary with min/max/avg values

Add this to your claude_desktop_config.json (typically found in %APPDATA%\Claude on Windows or ~/Library/Application Support/Claude on macOS):

{
  "mcpServers": {
    "valenciaSmartCity": {
      "command": "uv",
      "args": ["run", "valencia_traffic_mcp.py"]
    }
  }
}

Alternatively, install directly with:

mcp install valencia_traffic_mcp.py --name "Valencia Smart City"

Run the server directly:

# Run with MCP Inspector for development
mcp dev valencia_traffic_mcp.py

# Run directly (stdio transport)
python valencia_traffic_mcp.py

This server connects to the following data sources:

Valencia's open data platform:
- Traffic data: estat-transit-temps-real-estado-trafico-tiempo-real
- Bike stations: valenbisi-disponibilitat-valenbisi-disponibilidad
- Air quality: estacions-contaminacio-atmosferiques-estaciones-contaminacion-atmosfericas
Open-Meteo API:
- Current weather data
- Weather forecast
- Historical weather data

MIT