World Data Hub -- MCP Server

An MCP (Model Context Protocol) server that gives Claude real-time access to world data by aggregating multiple free public APIs into a single, clean tool interface.

No API keys required. Every data source is free and open.

Features

| Tool | Description | Data Source | |---|---|---| | lookup_country | Get detailed country info -- population, languages, currencies, borders, and more | REST Countries | | get_weather | Current conditions + 7-day forecast for any coordinates on Earth | Open-Meteo | | convert_currency | Convert between ~30 currencies using European Central Bank rates | Frankfurter | | get_exchange_rates | List latest exchange rates for any supported base currency | Frankfurter | | search_countries_by_region | Browse all countries in a region, sorted by population | REST Countries |

Quick Start

1. Install dependencies

pip install -r requirements.txt

2. Run the server

python server.py

3. Connect to Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "world-data-hub": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Restart Claude Desktop. The five tools will appear automatically.

Example Queries

Once connected, try asking Claude:

"Tell me about Japan -- population, languages, capital."
"What's the weather like in Paris right now?"
"Convert 1000 USD to EUR."
"Show me exchange rates for GBP against USD, EUR, and JPY."
"List all countries in Africa sorted by population."
"Compare the weather in Tokyo and New York today."
"What currencies does Switzerland use?"

APIs Used

| API | Purpose | URL | |---|---|---| | REST Countries | Country data (population, languages, borders, etc.) | https://restcountries.com | | Open-Meteo | Weather forecasts and current conditions | https://open-meteo.com | | Frankfurter | Currency exchange rates from the ECB | https://frankfurter.dev |

All three APIs are free, require no authentication, and have generous rate limits.

Tech Stack

Python 3.10+
MCP SDK (mcp package with FastMCP) -- Anthropic's official Model Context Protocol SDK
httpx -- async HTTP client
pydantic -- data validation (MCP SDK dependency)

Project Structure

mcp-server-world-data-hub/
  server.py           # MCP server with all 5 tools
  requirements.txt    # Python dependencies
  README.md           # This file

License

MIT

MCP Servers