geomelon-mcp

geomelon-mcp

Geomelon 地理 API 用の MCP サーバーです。都市、国、地域、言語を、MCP 対応の AI クライアントが呼び出せるツールとして公開します。

ほかの連携方法をお探しですか？公式ライブラリの一覧は geomelon.dev/libraries をご覧ください。

2 種類のトランスポートが含まれています。

バイナリ	トランスポート	用途
geomelon-mcp	stdio	Claude Desktop、Cursor、Cline、Continue
geomelon-mcp-http	HTTP（ストリーミング可能）	Claude Code、リモート／ホスト型サーバー

必要条件

• Node.js 18+
• Geomelon API をサブスクライブ済みの RapidAPI キー — 省略可能です。以下のキー不要のデモモードをご覧ください

---

キー不要のデモモード

GEOMELON_API_KEY がなくてもサーバーを実行できます。無料の oneshot host を利用し、サインアップ不要で search_cities_autocomplete ツールのみを使用して起動します。それ以外のツールにはキーが必要です。RapidAPI をサブスクライブする前にサーバーを試すには、これが最も手軽な方法です。

セットアップなしですぐに試す

Geomelon では、このキー不要のデモと同じものを公開ホスト型インスタンスとして提供しています。npx もローカルプロセスも必要ありません。リモート MCP に対応したクライアント（Claude のウェブ／デスクトップコネクター、ChatGPT コネクター、MCP Inspector など）から、次の URL に接続してください。

https://mcp.geomelon.dev/mcp

サーバーを API キーなしで自分で実行した場合と同様に、search_cities_autocomplete のみを公開します。全 22 種類のツールを使うには、以下の手順で RapidAPI キーを設定して独自のインスタンスを実行してください。

---

Claude Code（HTTP）

サーバーを実行するディレクトリに .env ファイルを作成します。

cp .env.example .env
# then edit .env and set GEOMELON_API_KEY

サーバーを起動します（dotenv が .env を自動的に読み込みます）。

npx geomelon-mcp-http

Claude Code に登録します。

claude mcp add --transport http geomelon http://localhost:3000/mcp

接続を確認します。

claude mcp list

Claude Code を使用するときは、サーバーを常に実行しておく必要があります。別のポートを使う場合は PORT=your_port を設定し、それに応じて claude mcp add コマンドの URL を更新してください。

---

Claude Desktop（stdio）

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "geomelon": {
      "command": "npx",
      "args": ["-y", "geomelon-mcp"],
      "env": {
        "GEOMELON_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

保存後、Claude Desktop を再起動します。

---

Cursor / Windsurf / Cline（stdio）

エディターの MCP 設定に追加します。

{
  "geomelon": {
    "command": "npx",
    "args": ["-y", "geomelon-mcp"],
    "env": {
      "GEOMELON_API_KEY": "your_rapidapi_key_here"
    }
  }
}

---

リモート／ホスト型 HTTP サーバー

サーバー上に .env ファイルを作成します。

cp .env.example .env
# set GEOMELON_API_KEY and PORT in .env

サーバーを起動します。

npx geomelon-mcp-http

その後、URL に http://your-host:3000/mcp を指定して、任意の MCP クライアントに登録します。

HTTP トランスポートはステートレスです。各リクエストは独立しており、セッション管理は不要です。このトランスポートはブラウザー型のリモート MCP クライアントからも接続できるように設計されているため、CORS は広く開放されています（Access-Control-Allow-Origin: *）。GET /（または /health）は小さな JSON ステータスオブジェクトを返し、インスタンスにキーが設定されているかどうか（"mode": "full" または "mode": "keyless-demo"）を報告します。稼働状況の確認に便利です。

---

利用可能なツール

都市

ツール	説明
search_cities	名前、国コード、地域、人口の範囲、並べ替え順で検索
get_city	UUID を指定して都市の詳細を取得
get_city_translations	UUID を指定して都市名のすべての翻訳を取得
get_city_settlement_types	UUID を指定して都市の集落タイプ分類を取得
cities_by_coordinates_closest	緯度／経度に最も近い都市を距離順に取得
cities_by_coordinates_largest	緯度／経度付近の最大都市を人口順に取得
cities_distance	2 つの都市間の距離を km 単位で取得

国

ツール	説明
list_countries	国の一覧を取得。名前の接頭辞または電話の国番号で絞り込み可能
get_country	UUID を指定して国の詳細を取得（翻訳と地域を含む）
get_country_translations	UUID を指定して国名の翻訳を取得
get_country_regions	UUID を指定して国のすべての行政地域を取得

地域

ツール	説明
list_regions	地域を一覧表示します。国の UUID で絞り込めます
get_region	UUID で指定した地域の詳細情報を取得します
get_region_translations	UUID で指定した地域名の翻訳を取得します

言語

ツール	説明
list_languages	データベース内のすべての言語を一覧表示します
get_language	UUID で指定した言語の詳細情報を取得します

1 回限りのプレフィックス検索（無料、API キー不要）

ツール	説明
search_cities_autocomplete	事前構築された静的ファイルを使用した、国と言語を指定して市名のプレフィックスを検索するツールです。キー不要のデモモードで利用できる唯一のツールです。キーを指定したモードでも利用でき、最速の検索方法です。

対応する国と言語の組み合わせ、および基盤となる HTTP エンドポイントについては、geomelon.dev/free-city-autocomplete-api をご覧ください。

---

複合ツール

これらのツールは、複数の API 呼び出しを内部で連鎖させ、往復回数を減らします。

ツール	説明
find_cities_near_city	都市の UUID を指定して、距離または人口順に近隣都市を検索します
city_context	都市と、その国および地域の詳細情報をまとめて 1 回の呼び出しで取得します
country_overview	UUID または名前で指定した国と、その地域、および人口上位の都市を取得します
compare_cities	2 つの都市とその間の距離を 1 回の呼び出しで取得します
search_cities_in_country	ISO コードの代わりに国名を使用して都市を検索します