Jana

You run a hosted MCP server that exposes environmental data via a fast, real-time interface. It connects to Jana’s backend to provide air quality, emissions, and geographic search capabilities through a simple client workflow. This guide shows you how to use the server, install and run it, and configure it for reliable access by your MCP clients.

How to use

Connect with your MCP client to the server’s SSE endpoint to receive data streams and query results. You can perform air quality lookups, retrieve emissions data, and execute proximity and trend analyses. Use the configured http endpoint to establish a persistent connection and issue data requests through your client’s MCP tooling. Monitor data availability and system health as you work, so you always know when data sources are up or when the service is experiencing issues.

How to install

Prerequisites you need before starting: Docker and Docker Compose are required to run the server in containerized mode.

1. Prepare the environment. Create and edit your environment file to supply Jana backend credentials and server settings.

cp dotenv.example .env

# Edit the file to include your Jana backend URL and credentials

2. Start the server in standalone mode if the Jana backend runs on the host. Use Docker Compose to build and run the container.

docker-compose up --build

3. Start the Jana backend and then the MCP server if you prefer to run the entire stack on the same Docker network.

# Start Jana backend first
cd ../Jana
docker-compose up -d

# Then start the MCP server with overrides
cd ../jana-mcp-server
docker-compose -f docker-compose.yml -f docker-compose.override.yml up --build

4. Verify the MCP server URL. By default, the MCP server will be available at http://localhost:8080.

5. Configure your MCP client to connect to the server’s SSE endpoint. You will provide the URL in your client’s MCP configuration as shown in the example configuration snippet.

Configuration and client setup

You need to supply the Jana backend credentials and the MCP server port as shown below. Create or update your environment file with the following values.

JANA_BACKEND_URL=http://host.docker.internal:8000
JANA_USERNAME=your_username
JANA_PASSWORD=your_password
JANA_TOKEN=optional_token
MCP_SERVER_PORT=8080
LOG_LEVEL=INFO

Available tools

get_air_quality

Query air quality measurements such as PM2.5, PM10, O3, NO2, SO2, CO from OpenAQ.

get_emissions

Query facility-level and national greenhouse gas emissions from Climate TRACE and EDGAR.

find_nearby

Perform geographic searches by bounding box, point radius, or country to locate data.

get_trends

Analyze temporal trends in environmental data to understand patterns over time.

get_data_summary

Provide a high-level summary of available platform data.

get_system_health

Check the health and status of the MCP service and data sources.