Postgis Yukon MCP

🚀 PostGIS MCP Server

本プロジェクトはfastMCPフレームワークを用いて、PostGIS地理空間データベースツールをカプセル化し、MCP（Model Context Protocol）プロトコルを通じて標準化されたツールインターフェースを提供します。

🚀 クイックスタート

本プロジェクトを使用するには、まず依存関係をインストールし、PostGISデータベースの接続情報を設定し、最後にサービスを起動する必要があります。詳細な手順は以下の通りです。

依存関係のインストール

pip install -r requirements.txt

設定の説明

使用する前に、PostGISデータベースの接続情報を設定する必要があります。

# src/config/database.py
DB_CONFIG = {
    "host": "localhost",
    "port": 5432,
    "database": "your_database",
    "user": "your_user",
    "password": "your_password"
}

サービスの起動

python -m src.server

✨ 主な機能

🌟 新機能: Text-to-SQL

現在、自然言語でPostGISデータベースをクエリすることがサポートされています！複雑なSQL文を書く必要はありません。中国語または英語でクエリの要件を記述するだけです。

例：

• "クエリテーブル:buildings 座標120.5,30.2 の近く500メートル以内の建物"
• "テーブル:roads に100メートルのバッファを作成"
• "テーブル:parks の面積を計算"

詳細は Text-to-SQLドキュメント を参照してください。

各種ツール

空間クエリツール（3つ）

• query_nearby - 座標に基づいて近くの地理要素をクエリする
• query_bbox - 空間範囲クエリ
• query_attribute - 属性に基づいて要素をクエリする

幾何操作ツール（5つ）

• buffer_geometry - 幾何バッファを作成する
• get_area - 幾何面積を計算する
• get_length - 幾何長さを計算する
• transform_coords - 座標系を変換する
• simplify_geom - 幾何オブジェクトを簡略化する

空間分析ツール（5つ）

• measure_distance - 2つの幾何オブジェクト間の距離を計算する
• test_intersection - 幾何オブジェクトの交差関係をチェックする
• test_containment - 幾何オブジェクトの包含関係をチェックする
• union_geoms - 複数の幾何オブジェクトを結合する
• get_centroid - 幾何オブジェクトの重心を計算する

データベース管理ツール（9つ）

• postgis_version - PostGISのバージョン情報を取得する
• list_extensions - インストールされているデータベース拡張をリストする
• discover_spatial_tables - 空間フィールドを含むテーブルを検出する
• table_info - テーブルの詳細な空間情報を取得する
• create_index - 空間列にGISTインデックスを作成する
• analyze - テーブルを分析して統計情報を更新する
• vacuum - テーブルをクリーンアップして空間を回収する
• spatial_extent - テーブルの空間範囲を取得する
• validate_geometries - 幾何オブジェクトの有効性をチェックする

高度な空間分析ツール（8つ）

• join_spatial - 空間結合操作を実行する
• find_nearest - 最近のK個の近傍を検索する
• cluster_spatial - DBSCANを使用して空間クラスタリングを行う
• compute_convex_hull - 凸包を計算する
• generate_voronoi - ボロノイ多角形を生成する
• interpolate_line - 線分に沿って点を補間する
• snap_geometry - 幾何オブジェクトをグリッドにスナップする
• split_line - 点を使用して線分を分割する

Text-to-SQLツール（2つ）

• nl_to_sql - 自然言語をPostGIS SQL文に変換する
• execute_sql - SQLクエリを安全に実行する（ユーザーの確認が必要）

合計32個の専用PostGISツール

📦 インストール

依存関係のインストールについては、「クイックスタート」の「依存関係のインストール」を参照してください。

💻 使用例

基本的な使用法

MCPプロトコルを介してツールを呼び出す例です。

# 指定された座標の近くの要素をクエリする
result = await mcp_client.call_tool(
    "query_nearby",
    {
        "longitude": 120.123,
        "latitude": 30.456,
        "radius": 1000
    }
)

📚 ドキュメント

プロジェクト構造

yukon_mcp_service/
├── src/
│   ├── __init__.py           # パッケージの初期化
│   ├── server.py             # MCPサーバーのメインエントリー
│   ├── tools/                # ツールモジュール
│   │   ├── __init__.py
│   │   ├── spatial_query.py  # 空間クエリツール
│   │   ├── geometry.py       # 幾何操作ツール
│   │   └── analysis.py       # 空間分析ツール
│   └── config/
│       ├── __init__.py
│       └── database.py       # データベースの設定
├── tests/                    # テストファイル
│   ├── __init__.py
│   └── test_tools.py
├── pyproject.toml            # プロジェクトの設定
├── requirements.txt          # 依存関係のリスト
└── README.md                 # プロジェクトの説明

開発ガイド

新しいツールの追加

1. src/tools/ ディレクトリに新しいツールモジュールを作成します。
2. @mcp.tool() デコレータを使用してツール関数を定義します。
3. server.py で新しいツールを登録します。

@mcp.tool()
async def my_spatial_tool(param1: str, param2: float) -> dict:
    """ツールの説明"""
    # 実装ロジック
    return {"result": "data"}

🔧 技術詳細

技術スタック

• Python 3.8+
• fastMCP
• PostGIS
• psycopg2
• asyncio

📄 ライセンス

MIT License