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 for PostgreSQL (Vorschau) .
Inhaltsverzeichnis
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;
brew intall visual-studio-code
Installieren
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
- 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",
]
}
}
}
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
Version 0.1.4
Version 0.1.3
Version 0.1.2
Version 0.1.1
Version 0.1.0a1
Lizenz
MIT-Lizenz