📝 mcp-ip-geo

📝 mcp-ip-geo

---

mcp-ip-geo は、ip-api.com サービスを利用して IP の位置情報（国、地域、都市など）を検索する MCP（Model Context Protocol）サーバーです。

🔌 MCP との統合

mcp-ip-geo サービスは、次の 2 つの方法で統合できます。

方法 1：go run コマンドを使用する（Stdio）

GitHub から最新バージョンを直接実行するには、次の設定を MCP に追加してください。

{
  "mcpServers": {
    "mcp-ip-geo": {
      "command": "go",
      "args": [
        "run",
        "github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest"
      ]
    }
  }
}

方法 2：Docker を使用する（Streamable HTTP）

🐳 Docker のデプロイ

手順 1：リポジトリをクローンする

git clone https://github.com/chenmingyong0423/mcp-ip-geo.git
cd mcp-ip-geo

手順 2：Docker イメージをビルドする

docker build -t mcp-ip-geo-server .

手順 3：コンテナを実行する

docker run -d --name mcp-ip-geo-server -p 8000:8000 mcp-ip-geo-server

正常に起動すると、サービスはコンテナ内の 0.0.0.0:8000 でリッスンします（すべてのネットワークインターフェースでリッスン）。http://<server-address>:8000/mcp からアクセスできます。<server-address> には、次のいずれかを指定できます。

• ローカル開発環境：localhost または 127.0.0.1
• LAN 環境：サーバーの内部 IP アドレス（例：192.168.x.x）
• パブリックネットワーク環境：サーバーのパブリック IP アドレスまたはドメイン名

注：コンテナ内でサービスが 0.0.0.0 アドレスをリッスンするように設定されています。これはコンテナ化されたアプリケーションで標準的な設定であり、コンテナの外部からサービスにアクセスできるようにするものです。

手順 4：MCP を設定する

次の設定を MCP に追加してください。

{
  "mcpServers": {
    "mcp-ip-geo": {
      "url": "http://<server-address>:8000/mcp"
    }
  }
}

<server-address> は、デプロイ環境の実際のサーバー IP アドレスまたはドメイン名に置き換えてください。

⚠️ ライセンスに関する注意

注：このプロジェクトでは ip-api.com の無料版を使用しています。無料版は非商用利用のみを対象としています。このプロジェクトを商用目的で使用する場合は、利用規約を遵守するか、有料版をご購入ください：https://ip-api.com/