home / mcp / tmd earthquake mcp server

TMD Earthquake MCP Server

Provides real-time earthquake data from TMD with search, filter, and summary tools via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "amornpan-tmd-earthquake-server-1.0": {
      "command": "python",
      "args": [
        "C:\\\\Users\\\\Asus\\\\2025-Aug-APT_LLMs-for-Telecom\\\\tmd-earthquake-server-1.0\\\\server.py"
      ]
    }
  }
}

You deploy this MCP server to access real-time earthquake data from the Thai Meteorological Department. It exposes a set of tools you can call through an MCP client to fetch recent earthquakes, filter by magnitude or location, get summaries, and identify large events. This guide walks you through using, installing, configuring, and troubleshooting the server so you can integrate live earthquake data into your workflows.

How to use

Connect with your MCP client to the tmd_earthquake server and use its tools to retrieve and filter earthquake data. You can fetch recent events, filter by magnitude, search by location, obtain a statistics summary, or identify large quakes that exceed a threshold. Use natural language commands or your MCP tooling interface to invoke the available tools and then handle the returned data in your application or analysis workflow.

How to install

Prerequisites you need before installation are Python 3.10 or higher, pip, and an internet connection to access the TMD data source. You should also have Claude Desktop if you plan to integrate with Claude in your workflow.

Recommended installation path (Automatic Script) for your environment is shown here. Choose the method that matches your operating system.

Windows

cd C:\Users\Asus\2025-Aug-APT_LLMs-for-Telecom\tmd-earthquake-server-1.0
install.bat

Linux or macOS

cd /path/to/tmd-earthquake-server-1.0
chmod +x install.sh
./install.sh

If you choose Manual Installation, follow these steps to set up a virtual environment, install dependencies, and prepare to run the server.

# Open your terminal

# Navigate to the server directory
cd C:\Users\Asus\2025-Aug-APT_LLMs-for-Telecom\tmd-earthquake-server-1.0

# Create a virtual environment (recommended)
pip install virtualenv
python -m venv venv

# Activate virtual environment
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Or install the MCP CLI and httpx directly
pip install "mcp[cli]" httpx

Additional configuration and notes

Claude Desktop configuration is required to connect this server to Claude. You add a server entry that points to the Python runtime and the server script.

{
  "mcpServers": {
    "tmd-earthquake": {
      "command": "python",
      "args": ["C:\\Users\\Asus\\2025-Aug-APT_LLMs-for-Telecom\\tmd-earthquake-server-1.0\\server.py"]
    }
  }
}

Troubleshooting and verification

If the server does not appear in Claude Desktop, check that Python is available and of the correct version, verify dependencies are installed, and review logs for MCP-related messages.

Common checks to perform quickly.

python --version
# Must be Python 3.10 or higher

pip list | grep mcp
# Ensure mcp is installed

# View logs for MCP server issues
# Windows
type %APPDATA%\\Claude\\logs\\mcp*.log
# Or open specific log files
notepad %APPDATA%\\Claude\\logs\\mcp-server-tmd-earthquake.log

# Test server directly
cd C:\\Users\\Asus\\2025-Aug-APT_LLMs-for-Telecom\\tmd-earthquake-server-1.0
python server.py

Tools you can use with the MCP client

The server exposes a set of practical data-access tools that you can call through an MCP client to obtain earthquake information.

Available tools

get_earthquakes

Fetch recent earthquake data with a limit on items (default 10)

get_earthquakes_by_magnitude

Filter earthquakes by a minimum magnitude threshold (default 3.0)

get_earthquakes_by_location

Search earthquakes by location name (Thai or English)

get_earthquake_summary

Get a statistics summary for earthquakes

get_large_earthquakes

Find earthquakes exceeding a magnitude threshold (default 5.0)