Rioriost Homebrew Age MCP Server

🚀 AGE - MCP - Server 日本語ドキュメント

AGE - MCP - Serverは、特定のデータベース操作を行うためのサーバーです。PostgreSQLとAGE拡張を利用し、グラフデータベースの操作をサポートしています。

🚀 クイックスタート

このセクションでは、AGE - MCP - Serverを使用するための基本的な手順を説明します。まずは、必要なソフトウェアをインストールし、サーバーを起動しましょう。

✨ 主な機能

• PostgreSQLとAGE拡張を利用したグラフデータベース操作のサポート。
• 複数のインストール方法を提供し、異なる環境での利用を可能に。
• グラフデータベースのクエリやデータの操作をサポート。

📦 インストール

前提条件

PostgreSQLのインストール

• オペレーティングシステムの要件：
  • Windows: PostgreSQL 公式ダウンロードページ
  • macOS: Homebrewを使用してインストール：brew install postgresql
  • Linux: ディストリビューションに応じてインストールします。例えば、Debian/Ubuntuの場合：sudo apt-get install postgresql postgresql-contrib

AGE拡張の有効化

1. PostgreSQLデータベースを開きます。
2. 以下のコマンドを実行してAGE拡張を有効化します。

   CREATE EXTENSION age;
   

インストール方法

brewを使用する場合（macOSのみ）

brew install age-mcp-server

uvを使用する場合

1. UVをダウンロードしてインストールします：UV 公式ダウンロードページ
2. UVを起動し、以下のコマンドを実行します：

   uv age-mcp-server
   

Python仮想環境を使用する場合

pip install age-mcp-server

💻 使用例

設定ファイルの場所

• Windows: C:\Users\<Username>\AppData\Local\Claude 2\mcp-server\config.json
• macOS/Linux: ~/.config/Claude 2/mcp-server/config.json

設定例（config.json）

{
  "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"
      ]
    }
  }
}

グラフィカルユーザーインターフェイスの操作例

• クエリ1: すべての顧客とその購入金額を表示します。
• クエリ2: 特定の顧客の総購入金額を計算します。
• クエリ3: Lisaよりも購入金額の多い他の顧客を検索します。
• クエリ4: 新しいグラフ MCP_Test を作成します。
• クエリ5: ノードとリレーションシップを追加します。

グラフィカルユーザーインターフェイスのスクリーンショット

• Windows:

📚 ドキュメント

書き込み操作

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

• 依存関係を更新しました。

バージョン 0.2.2

• CREATE 操作の説明に RETURN 条件のテストを追加しました。

バージョン 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
• 公式ドキュメント: Apache AGE ドキュメント

📄 ライセンス

• MITライセンス