MCP Server Location

🚀 位置 MCP 服務器

一個基於 MCP（模型上下文協議）的位置服務器，提供 IP 地址定位和經緯度查詢功能，能幫助用戶快速獲取地理位置信息。

🚀 快速開始

本位置 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 頁面上提交。