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 を起動します。

Visual Studio Code での使用

インストール後、[環境設定]->[設定]を選択し、[検索設定]に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モードに切り替えます。

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

書き込み操作

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.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

Integrations