Skip to main content
Glama
README.md
# gsj-geology-mcp

指定地点の岩相・地質年代や、指定範囲に含まれる地質の凡例を、産総研のシームレス地質図から確認できます。読み取り専用で、APIキーの設定は不要です。[uv](https://docs.astral.sh/uv/) と Git が必要です。Python 3.12以上に対応しています。

[MCP登録](#mcpクライアントに登録する) · [CLI](#cliで使う) · [Pythonライブラリ](#pythonライブラリとして使う)

## MCPクライアントに登録する

[uv](https://docs.astral.sh/uv/) と Git を用意し、リポジトリをクローンします。Python 3.12以上が必要です。

```sh
git clone https://github.com/koizumikento/gsj-geology-mcp.git
cd gsj-geology-mcp
uv sync --locked
```

以下の `/absolute/path/to/gsj-geology-mcp` は、クローン先の絶対パスに置き換えてください。Windowsでも `C:/projects/gsj-geology-mcp` のようにスラッシュで指定できます。

### Codex

```sh
codex mcp add gsj-geology-mcp -- uv --directory "/absolute/path/to/gsj-geology-mcp" run --locked gsj-geology-mcp
codex mcp list
```

`codex mcp list` で登録を確認し、Codexの新しいセッションで `/mcp` を開くと、接続状態を確認できます。[Codexの公式設定ガイド](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)

Codexのデスクトップアプリでは、設定の「MCP servers」でSTDIOサーバーを追加し、下のJSON例と同じコマンド・引数を指定する方法もあります。

### Claude Desktop / Cursor

次のファイルに設定します。

- Claude Desktop(Windows) `%APPDATA%/Claude/claude_desktop_config.json`
- Claude Desktop(macOS) `~/Library/Application Support/Claude/claude_desktop_config.json`
- Cursor `.cursor/mcp.json`(プロジェクト内)

既に `mcpServers` がある場合は、その中にサーバーの項目を追加してください。保存後にクライアントを再起動し、ツールが表示されるか確認します。[設定ファイルの場所と接続手順](https://py.sdk.modelcontextprotocol.io/get-started/real-host/)

```json
{
  "mcpServers": {
    "gsj-geology-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/gsj-geology-mcp",
        "run",
        "--locked",
        "gsj-geology-mcp"
      ]
    }
  }
}
```

`uv` が見つからない場合は、設定のコマンドに実行ファイルの絶対パスを指定してください。

登録後は、チャットで次のように聞けます。

> 北緯39.700038度、東経141.149898度の地質年代と岩相を調べて。

## ツール

`get_geology` で緯度・経度から、地質図の岩相と地質年代を取得できます。

```json
{
  "latitude": 39.700038,
  "longitude": 141.149898
}
```

`get_area_geology` で矩形内に現れる地質の凡例一覧を取得できます。緯度・経度はWGS84で、南から北、西から東の幅はそれぞれ最大0.25度です。

```json
{
  "south": 39.69,
  "west": 141.13,
  "north": 39.71,
  "east": 141.16
}
```

結果は凡例記号順に並びます。`limit` は既定25件、最大100件で、続きがあれば `next_offset` を次の呼び出しの `offset` に指定します。`total` は範囲内の凡例件数です。

産総研地質調査総合センターの20万分の1日本シームレス地質図V2の凡例を返します。地図の縮尺と出典を結果に含めます。地点の地盤強度や敷地の地質調査には、別途適切な資料・調査が必要です。

## CLIで使う

上の登録手順でクローンしたディレクトリで実行します。

```sh
uv run gsj-geology-mcp get-geology --latitude 39.700038 --longitude 141.149898
uv run gsj-geology-mcp get-area-geology --south 39.69 --west 141.13 --north 39.71 --east 141.16
```

結果は標準出力にUTF-8のJSONで出力します。コマンドの引数は `uv run gsj-geology-mcp get-geology --help` で確認できます。

## Pythonライブラリとして使う

自分のPythonプロジェクト(`pyproject.toml` があるディレクトリ)で依存関係に追加します。

```sh
uv add "git+https://github.com/koizumikento/gsj-geology-mcp.git@main"
```

次のコードを `example.py` に保存し、同じディレクトリで `uv run python example.py` を実行します。

```python
import asyncio

from gsj_geology_mcp import get_geology

result = asyncio.run(get_geology(latitude=39.700038, longitude=141.149898))
print(result)
```

公開関数 `get_geology` と `get_area_geology` を利用できます。イベントループがある環境では、関数を直接 `await` します。

## 出典と利用条件

コードはMIT Licenseです。上流データの権利と利用条件は各提供元の定めに従います。[公式仕様](https://gbank.gsj.jp/seamless/v2/api/1.3.1/) · [利用案内](https://gbank.gsj.jp/seamless/agreement.html)

## 開発

```sh
uv sync --locked
uv run ruff check .
uv run ty check
uv run pytest
uv build
```