MeasureSpace MCP

What is measure-space-mcp-server?

measure-space-mcp-server is a free Model Context Protocol (MCP) server built with FastAPI that provides comprehensive weather, climate, air quality, and geocoding services. It leverages data from measurespace.io and is specifically designed to be used by AI assistants to retrieve environmental and location-based information.

How to use measure-space-mcp-server?

There are two primary ways to install and use measure-space-mcp-server:

Installing via Smithery

For automatic installation with Claude Desktop, use the Smithery CLI:

npx -y @smithery/cli install @MeasureSpace/measure-space-mcp-server --client claude

Manual Installation

1. Clone the repository:

   git clone git@github.com:MeasureSpace/measure-space-mcp-server.git
   cd measure-space-mcp-server
   

2. Install dependencies:

   uv venv
   uv pip install -e .
   

3. Configure API keys: Create a .env file in the project root with necessary API keys from measurespace.io (e.g., GEOCODING_API_KEY, HOURLY_WEATHER_API_KEY).

Running the Server

After installation, you can run the server:

python main.py

The server will typically start on http://localhost:8000.

Integration with Claude Desktop App

To use with Claude Desktop, modify cladue_desktop_config.json to include the server configuration, pointing to your uv executable and the project directory.

Key Features of measure-space-mcp-server

measure-space-mcp-server offers a robust set of features:

• Weather Forecasts: Hourly (5 days) and daily (15 days) weather forecasts.
• Climate Forecasts: Daily climate forecasts for the next 9 months.
• Air Quality Forecasts: Hourly and daily air quality forecasts for the next 4 days.
• Geocoding Services:
  • Find latitude and longitude for city names.
  • Find the nearest city for given latitude and longitude.
• Timezone Information: Provides accurate timezone data.
• Astronomy Data: Includes sunrise and sunset times.

Use Cases of measure-space-mcp-server

This server is ideal for:

• AI Assistants: Enhancing AI assistants with real-time weather, climate, and location-based information.
• Environmental Monitoring: Applications requiring detailed air quality and climate data.
• Location-Based Services: Integrating geocoding functionalities into various platforms.
• Data Analysis: Providing a reliable source of environmental data for analytical purposes.

FAQ about measure-space-mcp-server

Q: What are the main requirements to run this server? A: You need Python 3.12+, the uv package manager, and relevant API keys from measurespace.io.

Q: Do I need all API keys from measurespace.io? A: No, you only need the API keys for the specific services you intend to use.

Q: Can I use this server with other AI platforms besides Claude Desktop? A: While specifically mentioned for Claude Desktop, as an MCP server, it is designed to be compatible with any AI assistant or platform that supports the Model Context Protocol.

Q: Where can I find more documentation on measurespace.io API keys? A: You can find documentation and pricing information on the measurespace.io website, specifically at https://measurespace.io/documentation#global-climate-forecast-variables and https://measurespace.io/pricing.

MCP Server for Measure Space API Services

A Model Context Protocol (MCP) server for weather, climate, and air quality forecast and geocoding services from measurespace.io, built with FastAPI and the MCP framework. This server provides various weather, climate, air quality and geocoding related tools that can be used by AI assistants to retrieve weather, climate and air quality forecasts and more.

Features

• Hourly weather forecast for next 5 days
• Daily weather forecast for next 15 days
• Daily climate forecast for next 9 months
• Hourly and daily air quality forecast for next 4 days
• Geocoding service for finding latitude and longitude for given city names
• Geocoding service for find nearest city for given latitude and longitude
• Timezone information
• Astronomy data (sunrise, sunset)

Requirements

• Python 3.12+
• uv package manager
• Related service API keys from measurespace.io

Installation

Installing via Smithery

To install this server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @MeasureSpace/measure-space-mcp-server --client claude

Manual Installation

1. Clone this repository:

   git clone git@github.com:MeasureSpace/measure-space-mcp-server.git
   cd measure-space-mcp-server
   

2. Install dependencies using uv:

   uv venv
   uv pip install -e .
   

3. Create a .env file in the project root with your related API keys from measurespace.io:

   GEOCODING_API_KEY=<your-geocoding-api-key>
   HOURLY_WEATHER_API_KEY=<your-hourly-weather-api-key>
   DAILY_WEATHER_API_KEY=<your-daily-weather-api-key>
   DAILY_WEATHER_API_KEY=<your-daily-climate-api-key>
   AIR_QUALITY_API_KEY=<your-air-quality-api-key>
   

   Note that you only need the API key for the service your need.

Usage

Use the server with Claude Desktop App

Open the cladue_desktop_config.json file and add the following setup. Restart the Claude Desktop App. Please see this tutorial if you don't know where to find the cladue_desktop_config.json file.

{
  "mcpServers": {
    "MeasureSpace": {
      "command": "/<your_uv_path>/uv",
      "args": [
        "--directory",
        "/<your-measure-space-mcp-server-folder-path>/measure-space-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Run the server

# Go into your uv built environment
python main.py

The server will start on http://localhost:8000 by default.