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.