MCP Server Location

🚀 Location MCP Server

A location server based on MCP (Model Context Protocol), providing IP address location and latitude/longitude query functions.

🚀 Quick Start

A location server based on MCP (Model Context Protocol) that offers IP address location and latitude/longitude query capabilities.

✨ Features

• Supports location queries via IP addresses.
• Supports detailed address queries via latitude and longitude coordinates.
• Built upon Meituan's open API.
• Developed with TypeScript for type safety.
• Complies with the MCP protocol standard.

📦 Installation

npm install @v8tech/mcp-server-location -g

💻 Usage Examples

Basic Usage

The server provides two main tools:

1. IP Location Query (ip_location)

   • Input: IP address
   • Output: Detailed location information including country, province, city, district, etc.

2. Latitude/Longitude Location Query (latlng_location)

   • Input: Latitude (lat) and longitude (lng)
   • Output: Detailed address information including country, province, city, district, etc.

Advanced Usage

Here are the steps for development:

1. Clone the repository:

git clone https://github.com/v5tech/mcp-server-location.git
cd mcp-server-location

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Development mode (watch for file changes):

npm run watch

API Response Examples

IP Location Query Response

{
  "location": {
    "ip": "8.8.8.8",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822
    },
    "address": {
      "country": "United States",
      "province": "Kansas",
      "city": "Wichita",
      "district": "",
      "adcode": "US"
    }
  }
}

Latitude/Longitude Location Query Response

{
  "location": {
    "coordinates": {
      "latitude": 39.9042,
      "longitude": 116.4074
    },
    "address": {
      "country": "China",
      "province": "Beijing",
      "city": "Beijing",
      "district": "Dongcheng District",
      "detail": "Tiananmen Square",
      "areaName": "Dongcheng District"
    }
  }
}

📄 License

This project is released under the MIT License - see the LICENSE file for details.

Issues

If you encounter any issues while using this project, please feel free to submit them on the GitHub Issues page.