位置 MCP 服务器

中文 / English

一个基于 MCP（模型上下文协议）的位置服务器，提供 IP 地址定位和经纬度查询功能。

功能特点

• 支持通过 IP 地址进行位置查询
• 支持通过经纬度坐标进行详细地址查询
• 基于美团开放 API
• 使用 TypeScript 开发以确保类型安全
• 符合 MCP 协议标准

安装

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

使用方法

该服务器提供两个主要工具：

1. IP 位置查询（ip_location）

   • 输入：IP 地址
   • 输出：包含国家、省份、城市、区县等详细位置信息。

2. 经纬度位置查询（latlng_location）

   • 输入：纬度（lat）和经度（lng）
   • 输出：包含国家、省份、城市、区县等详细地址信息。

开发

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

4. 开发模式（监控文件变化）：

npm run watch

API 响应示例

1. IP 位置查询响应：

{
  "location": {
    "ip": "8.8.8.8",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822
    },
    "address": {
      "country": "美国",
      "province": "堪萨斯州",
      "city": "威奇塔",
      "district": "",
      "adcode": "US"
    }
  }
}

2. 经纬度位置查询响应：

{
  "location": {
    "coordinates": {
      "latitude": 39.9042,
      "longitude": 116.4074
    },
    "address": {
      "country": "中国",
      "province": "北京市",
      "city": "北京市",
      "district": "东城区",
      "detail": "天安门广场",
      "areaName": "东城区"
    }
  }
}

许可证

该项目在 MIT 许可证下发布 - 有关详细信息，请参阅 LICENSE 文件。

问题

如果您在使用此项目时遇到任何问题，请随时在 GitHub Issues 页面上提交。