AGE-MCP-サーバー

ライセンスパイソン

Apache AGE MCP サーバー

Apache AGE™ は、PostgreSQL の分散アセットと互換性のある PostgreSQL グラフデータベースであり、グラフデータ構造を活用してデータ内の関係性とパターンを分析および使用します。

Azure Database for PostgreSQL は、オープンソースの Postgres データベースエンジンをベースにしたマネージドデータベースサービスです。

Azure Database for PostgreSQL (プレビュー) でのグラフデータのサポートを導入します。

前提条件

Python 3.13以上
このモジュールはpsycopg上で動作します
Azure Database for PostgreSQL インスタンスで Apache AGE 拡張機能を有効にします。Azure Portal にログインし、「サーバーパラメーター」ブレードに移動して、「azure.extensions」および「shared_preload_libraries」パラメーター内の「AGE」をオンにしてください。詳細については、上記のブログ投稿をご覧ください。
PostgreSQL データベースに AGE 拡張機能をロードします。

CREATE EXTENSION IF NOT EXISTS age CASCADE;

Claude Claudeデスクトップクライアントからダウンロードするか、

brew install claude

Visual Studio Code Insiders Visual Studio Codeからダウンロードするか、

brew intall visual-studio-code

インストール

醸造酒とともに

brew tap rioriost/age-mcp-server
brew install age-mcp-server

紫外線付き

uv init your_project
cd your_project
uv venv
source .venv/bin/activate
uv add age-mcp-server

macOS / Linuxでpython venvを使用する

mkdir your_project
cd your_project
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install age-mcp-server

WindowsでPython venvを使用する

mkdir your_project
cd your_project
python -m venv venv
.\venv\Scripts\activate
python -m pip install age-mcp-server

クロードとの使用

macOS ではclaude_desktop_config.json``~/Library/Application Support/Claude/にあります。
Windows では%APPDATA%\Claudeの下に新しいclaude_desktop_config.jsonを作成する必要があります。
macOS上のHomebrew

Homebrew はage-mcp-serverを $PATH にインストールします。

{
  "mcpServers": {
    "age-manager": {
      "command": "age-mcp-server",
      "args": [
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username password=your_password",
      ]
    }
  }
}

uv / Pyhon venv

macOSの場合:

{
  "mcpServers": {
    "age-manager": {
      "command": "/Users/your_username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your_project",
        "run",
        "age-mcp-server",
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username password=your_password",
      ]
    }
  }
}

Windowsの場合:

{
  "mcpServers": {
    "age-manager": {
      "command": "C:\\Users\\USER\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\path\\to\\your_project",
        "run",
        "age-mcp-server",
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username password=your_password",
      ]
    }
  }
}

パスワードを非表示にしたり、Entra ID を使用する必要がある場合は、次のように--pg-con-strを設定できます。

{
  "mcpServers": {
    "age-manager": {
        ...
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username",
        ...
      ]
    }
  }
}

また、 PGPASSWORD環境変数を設定するか、 Azure CLI をインストールしてAzure アカウントでAzure にサインインする必要があります。

claude_desktop_config.jsonを保存したら、Claude Desktop Client を起動します。

サーバー上のグラフを表示する FROM_AGEFREIGHTERのグラフスキーマを表示してください顧客をピックアップして購入金額を計算します。リサより多く購入する別の顧客を見つけるわかりました。MCP_Testという名前の新しいグラフを作成してください。プロパティ name=Rio、age=52 を持つ「Person」というラベルのノードを作成します。プロパティが「Company」である別のノードを name=Microsoft で作成してください。「Rio WORK at Microsoft」という関係を記載してもらえますか? グラフMCP_Testを削除します

Windows のクロード

Visual Studio Code での使用

インストール後、[環境設定]->[設定]を開き、[検索設定]にmcpと入力してください。

環境設定のMCP設定

次のようにsettings.jsonを編集します。

{
    "mcp": {
        "inputs": [],
        "servers": {
            "age-manager": {
            "command": "/Users/your_user_name/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/your_project",
                "run",
                "age-mcp-server",
                "--pg-con-str",
                "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username password=your_password",
                "--debug"
            ]
            }
        }
    }
}

そして、AGE MCP サーバーのstartが開始されます。

チャットウィンドウをagentモードに切り替えます。

VSCodeエージェント

これで、Visual Studio Code 経由でグラフデータを操作できるようになりました。

VSCodeエージェント

書き込み操作

AGE-MCP-Serverは安全のため、デフォルトで書き込み操作を禁止しています。書き込み操作を有効にするには、 --allow-writeフラグを使用してください。

{
  "mcpServers": {
    "age-manager": {
      "command": "age-mcp-server",
      "args": [
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username password=your_password",
        "--allow-write"
      ]
    }
  }
}

リリースノート

0.2.10 リリース

依存関係の更新

0.2.9 リリース

依存関係の更新

0.2.8 リリース

VSCode(安定版)のサポートを追加

0.2.7 リリース

VSCode Insiders のサポートを追加

0.2.6 リリース

タイプミスを修正する

0.2.5 リリース

Entra IDとの接続をサポート

0.2.4 リリース

依存関係の更新

0.2.3 リリース

依存関係の更新

0.2.2 リリース

write-age-cypherツールの説明にRETURNを追加して、 CREATE操作の条件テストを削除します。

0.2.1 リリース

ノード/エッジ作成時のバグを修正

0.2.0 リリース

複数のグラフのサポートを追加
グラフの作成と削除のサポートを追加
廃止された--graph-name引数

0.1.8 リリース

--allow-writeフラグを追加

0.1.7 リリース

Windowsサポートを追加

0.1.6 リリース

RETURN値のパーサーを修正

0.1.5 リリース

ドラフトリリース

0.1.4 リリース

ドラフトリリース

0.1.3 リリース

ドラフトリリース

0.1.2 リリース

ドラフトリリース

0.1.1 リリース

ドラフトリリース

0.1.0a1 リリース

ドラフトリリース

詳細情報

Apache AGE : https://age.apache.org/
GitHub : https://github.com/apache/age
ドキュメント: https://age.apache.org/age-manual/master/index.html

ライセンス

MITライセンス

AGE-MCP-Server