mcp-server-location

🚀 位置 MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

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

💻 使用示例

基础用法

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

IP 位置查询（ip_location）

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

经纬度位置查询（latlng_location）

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

开发使用

克隆仓库

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

安装依赖项

npm install

构建项目

npm run build

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

npm run watch

API 响应示例

IP 位置查询响应

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

经纬度位置查询响应

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

📄 许可证

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

问题反馈

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