AGE-MCP-Server

Apache AGE MCP-Server

Apache AGE™ ist eine PostgreSQL-Graphdatenbank, die mit den verteilten Assets von PostgreSQL kompatibel ist und Graphdatenstrukturen nutzt, um Beziehungen und Muster in Daten zu analysieren und zu verwenden.

Azure Database für PostgreSQL ist ein verwalteter Datenbankdienst, der auf der Open-Source-Datenbank-Engine Postgres basiert.

Einführung der Unterstützung für Graphdaten in Azure Database für PostgreSQL (Vorschau) .

Inhaltsverzeichnis

• Voraussetzungen

• Installieren

• Verwendung mit Claude

• Verwendung mit Visual Studio Code Insidern

• Schreibvorgänge

• Versionshinweise

• Weitere Informationen

• Lizenz

Related MCP server: Database Tools for Claude AI

Voraussetzungen

• Python 3.13 und höher

• Dieses Modul läuft auf psycopg

• Aktivieren Sie die Apache AGE-Erweiterung in Ihrer Azure Database for PostgreSQL-Instanz. Melden Sie sich im Azure-Portal an, öffnen Sie das Blatt „Serverparameter“ und aktivieren Sie „AGE“ in den Parametern „azure.extensions“ und „shared_preload_libraries“. Weitere Informationen finden Sie im obigen Blogbeitrag.

• Laden Sie die AGE-Erweiterung in Ihre PostgreSQL-Datenbank.

CREATE EXTENSION IF NOT EXISTS age CASCADE;

• Claude Download vom Claude Desktop Client oder,

brew install claude

• Visual Studio Code Insiders Download von Visual Studio Code oder,

brew intall visual-studio-code

Installieren

• mit Gebräu

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

• mit UV

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

• mit Python Venv auf macOS / Linux

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

• mit Python Venv unter Windows

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

Verwendung mit Claude

• Unter macOS befindet sich claude_desktop_config.json in ~/Library/Application Support/Claude/ .

• Unter Windows müssen Sie unter %APPDATA%\Claude eine neue claude_desktop_config.json erstellen.

• Homebrew auf macOS

Homebrew installiert age-mcp-server in $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

Unter 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",
      ]
    }
  }
}

Unter 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",
      ]
    }
  }
}

Wenn Sie das Passwort verbergen oder die Entra-ID verwenden müssen, können Sie --pg-con-str wie folgt festlegen.

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

Außerdem müssen Sie die Umgebungsvariable PGPASSWORD festlegen oder Azure CLI installieren und sich mit Ihrem Azure-Konto bei Azure anmelden .

Starten Sie den Claude Desktop Client, nachdem Sie claude_desktop_config.json gespeichert haben.

Verwendung mit Visual Studio Code

Nach der Installation gehen Sie zu [Einstellungen] -> [Einstellungen] und geben Sie mcp in [Einstellungen suchen] ein.

Bearbeiten Sie die Datei settings.json wie folgt:

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

Und dann sehen Sie, wie der AGE MCP-Server start .

Wechseln Sie das Chat-Fenster in den agent .

Jetzt können Sie über Visual Studio Code mit Ihren Diagrammdaten spielen!

Schreibvorgänge

Der AGE-MCP-Server verhindert Schreibvorgänge standardmäßig aus Sicherheitsgründen. Wenn Sie Schreibvorgänge aktivieren möchten, können Sie das Flag --allow-write verwenden.

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

Versionshinweise

Version 0.2.10

• Abhängigkeitsaktualisierung

Version 0.2.9

• Abhängigkeitsaktualisierung

Version 0.2.8

• Unterstützung für VSCode hinzufügen (stabil)

Version 0.2.7

• Unterstützung für VSCode Insider hinzufügen

Version 0.2.6

• Einen Tippfehler korrigieren

Version 0.2.5

• Support-Verbindung mit Entra ID

Version 0.2.4

• Abhängigkeitsaktualisierung

Version 0.2.3

• Abhängigkeitsaktualisierung

Version 0.2.2

• Löschen Sie einen bedingten Test der CREATE -Operation, indem Sie der Beschreibung für write-age-cypher Tool RETURN hinzufügen.

Version 0.2.1

• Beheben Sie einen Fehler bei der Knoten-/Kantenerstellung

Version 0.2.0

• Unterstützung für mehrere Grafiken hinzufügen

• Unterstützung für die Erstellung und Löschung von Diagrammen hinzufügen

• Veraltetes Argument --graph-name

Version 0.1.8

• Flag --allow-write hinzufügen

Version 0.1.7

• Windows-Unterstützung hinzufügen

Version 0.1.6

• Parser für RETURN -Werte reparieren

Version 0.1.5

• Entwurfsfreigabe

Version 0.1.4

• Entwurfsfreigabe

Version 0.1.3

• Entwurfsfreigabe

Version 0.1.2

• Entwurfsfreigabe

Version 0.1.1

• Entwurfsfreigabe

Version 0.1.0a1

• Entwurfsfreigabe

Weitere Informationen

• Apache AGE: https://age.apache.org/

• GitHub: https://github.com/apache/age

• Dokument: https://age.apache.org/age-manual/master/index.html

Lizenz

MIT-Lizenz