MCP Server Location

🚀 位置 MCP サーバー

MCP（モデルコンテキストプロトコル）に基づく位置サーバーで、IP アドレスの位置特定と緯度経度の照会機能を提供します。

🚀 クイックスタート

このサーバーは、IP アドレスと緯度経度を使った位置情報の照会を可能にする、MCP プロトコルに基づく位置サーバーです。

✨ 主な機能

• IP アドレスによる位置照会をサポート
• 緯度経度座標による詳細住所照会をサポート
• メイトグループのオープン API に基づく
• 型安全を確保するために TypeScript で開発
• MCP プロトコル標準に準拠

📦 インストール

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

💻 使用例

基本的な使用法

このサーバーは 2 つの主要なツールを提供します。

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 ページに投稿してください。