🌍 TMD Earthquake MCP Server v1.0

Model Context Protocol (MCP) server for real-time earthquake data access from Thai Meteorological Department (TMD)

📋 Table of Contents

• Features
• System Requirements
• Installation
• Claude Desktop Configuration
• Usage
• Example Commands
• API Reference
• Troubleshooting

✨ Features

🛠️ Tools

This server provides tools for searching and analyzing earthquake data:

📚 Resources

📊 Data Provided

• 📅 Date and time (both UTC and Thai time)
• 📍 Location coordinates (Latitude, Longitude)
• 🎯 Epicenter depth (kilometers)
• 📊 Earthquake magnitude
• 🌏 Event location (in Thai)
• 💬 Additional details

💻 System Requirements

• Python 3.10 or higher
• pip (Python package manager)
• Internet connection for TMD API access
• Claude Desktop (for Claude integration)

🚀 Installation

Method 1: Automatic Script (Recommended)

Windows:

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

Linux/Mac:

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

Method 2: Manual Installation

1. Open Command Prompt/Terminal

2. Navigate to server directory:

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

1. Create virtual environment (optional but recommended):

python -m venv venv

# Windows
venv\Scripts\activate

# Linux/Mac
source venv/bin/activate

1. Install dependencies:

pip install -r requirements.txt

Or install separately:

pip install "mcp[cli]" httpx

⚙️ Claude Desktop Configuration

1. Locate Configuration File

Windows:

%APPDATA%\Claude\claude_desktop_config.json

or

C:\Users\[Username]\AppData\Roaming\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

2. Add Server Configuration

Open claude_desktop_config.json with a text editor and add:

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

Note:

• Use \\ (double backslash) for Windows paths
• If other servers exist, add after existing servers (don't forget the comma)

3. Restart Claude Desktop

1. Close Claude Desktop completely (including system tray)
2. Reopen Claude Desktop
3. Check for 🔌 icon indicating MCP server connection

📖 Usage

Direct Server Testing

# Test if server works
python server.py

# Use MCP Inspector (requires Node.js)
npx @modelcontextprotocol/inspector python server.py

Using in Claude Desktop

Once configured, use natural language commands with Claude:

💬 Example Commands

English

• "Show me recent earthquakes"
• "Find earthquakes with magnitude 4 or higher"
• "Are there any earthquakes in Myanmar?"
• "Give me a summary of earthquake activity"
• "Show today's earthquakes"
• "Find large earthquakes that might be dangerous"

Thai

• "แสดงข้อมูลแผ่นดินไหวล่าสุด"
• "หาแผ่นดินไหวที่มีขนาดมากกว่า 4 ริกเตอร์"
• "มีแผ่นดินไหวที่ประเทศเมียนมาบ้างไหม"
• "สรุปสถิติแผ่นดินไหวให้หน่อย"
• "แผ่นดินไหววันนี้มีกี่ครั้ง"
• "หาแผ่นดินไหวขนาดใหญ่ที่อาจเป็นอันตราย"

📊 API Reference

Tools

get_earthquakes(limit: int = 10)

Fetch recent earthquake data

• limit: Maximum number of items to retrieve (default: 10)
• Returns: List of earthquakes with details

get_earthquakes_by_magnitude(min_magnitude: float = 3.0)

Filter earthquakes by magnitude

• min_magnitude: Minimum magnitude threshold (default: 3.0)
• Returns: Earthquakes matching the magnitude criteria

get_earthquakes_by_location(location: str)

Search earthquakes by location

• location: Location/country name (Thai or English)
• Returns: Earthquakes in specified area

get_earthquake_summary()

Get earthquake statistics summary

• Returns: Total statistics, average magnitude, distribution by area

get_large_earthquakes(magnitude_threshold: float = 5.0)

Find large earthquakes

• magnitude_threshold: Magnitude threshold (default: 5.0)
• Returns: Earthquakes exceeding the threshold

Resources

earthquake://latest

• Returns: Latest earthquake data (1 item)

earthquake://today

• Returns: All earthquakes today (Thai timezone)

🔧 Troubleshooting

Server Not Appearing in Claude Desktop

1. Check Python:

python --version
# Must be Python 3.10 or higher

1. Check dependencies:

pip list | findstr mcp
# Must have mcp package

1. View logs:

# Windows
type %APPDATA%\Claude\logs\mcp*.log

# Or open with notepad
notepad %APPDATA%\Claude\logs\mcp-server-tmd-earthquake.log

1. Test server directly:

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

Common Error Messages

How to Verify Server is Working

1. Claude Desktop should show 🔌 or ⚡ icon
2. Type "Show MCP tools" in Claude
3. Should see tmd-earthquake server tools

📊 Data Source

• API Provider: Thai Meteorological Department (TMD)
• API Endpoint: https://data.tmd.go.th/api/DailySeismicEvent/v1/
• Update Frequency: Real-time
• Coverage: Regional and global

📄 License

This server is for educational and informational purposes. The earthquake data is provided by TMD.

🤝 Contributing

If you find issues or want to add features:

1. Create an Issue
2. Submit Pull Request
3. Contact the developer

📞 Support

If you need help:

• Check Troubleshooting first
• Review logs in %APPDATA%\Claude\logs\
• Test server directly with python server.py

Version: 1.0.0
Last Updated: 2025-08-15
Developed for: TMD Earthquake Data Access via MCP