mcp-server-location

Location MCP Server

中文 / English

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

Features

• Support location query by IP address
• Support detailed address query by latitude and longitude coordinates
• Based on Meituan Open API
• Developed with TypeScript for type safety
• Compliant with MCP protocol standard

Installation

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

Usage

The server provides two main tools:

1. IP Location (ip_location)

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

2. Latitude/Longitude Location (latlng_location)

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

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 changes):

npm run watch

API Response Examples

1. IP Location 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"
    }
  }
}

2. Latitude/Longitude Location Response:

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

License

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

Issues

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