Servidor AGE-MCP

Servidor Apache AGE MCP

Apache AGE™ es una base de datos gráfica PostgreSQL compatible con los activos distribuidos de PostgreSQL y aprovecha las estructuras de datos gráficos para analizar y utilizar relaciones y patrones en los datos.

Azure Database for PostgreSQL es un servicio de base de datos administrado que se basa en el motor de base de datos Postgres de código abierto.

Presentamos compatibilidad con datos de gráficos en Azure Database for PostgreSQL (versión preliminar) .

Tabla de contenido

• Prerrequisitos

• Instalar

• Uso con Claude

• Uso con Visual Studio Code Insiders

• Operaciones de escritura

• Notas de la versión

• Para más información

• Licencia

Related MCP server: Neo4j GraphRAG MCP Server

Prerrequisitos

• Python 3.13 y superior

• Este módulo se ejecuta en psycopg

• Habilite la extensión Apache AGE en su instancia de Azure Database for PostgreSQL. Inicie sesión en el Portal de Azure, vaya a la hoja "Parámetros del servidor" y marque "AGE" en los parámetros "azure.extensions" y "shared_preload_libraries". Consulte la entrada de blog anterior para obtener más información.

• Cargue la extensión AGE en su base de datos PostgreSQL.

CREATE EXTENSION IF NOT EXISTS age CASCADE;

• Claude Descargar desde Claude Desktop Client o,

brew install claude

• Descarga de Visual Studio Code Insiders desde Visual Studio Code o,

brew intall visual-studio-code

Instalar

• con cerveza

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

• con rayos ultravioleta

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

• con Python Venv en macOS / Linux

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

• con Python Venv en Windows

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

Uso con Claude

• en macOS, claude_desktop_config.json se encuentra en ~/Library/Application Support/Claude/ .

• en Windows, debe crear un nuevo claude_desktop_config.json en %APPDATA%\Claude .

• Homebrew en macOS

Homebrew instala age-mcp-server en $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

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

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

Si necesita ocultar la contraseña o usar Entra ID, puede configurar --pg-con-str de la siguiente manera.

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

Además, debe configurar la variable de entorno PGPASSWORD o instalar la CLI de Azure e iniciar sesión en Azure con su cuenta de Azure.

Después de guardar claude_desktop_config.json , inicie Claude Desktop Client.

Uso con Visual Studio Code

Después de la instalación, vaya a [Preferencias]->[Configuración] e ingrese mcp en [Configuración de búsqueda].

Edite el archivo settings.json de la siguiente manera:

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

Y luego verás start inicia el servidor AGE MCP.

Cambie la ventana de chat al modo agent .

¡Ahora puedes jugar con tus datos gráficos a través de Visual Studio Code!

Operaciones de escritura

AGE-MCP-Server prohíbe las operaciones de escritura por defecto por seguridad. Si desea habilitarlas, puede usar el indicador --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"
      ]
    }
  }
}

Notas de la versión

Versión 0.2.10

• Actualización de dependencia

Versión 0.2.9

• Actualización de dependencia

Versión 0.2.8

• Añadir soporte para VSCode (estable)

Versión 0.2.7

• Añadir soporte para VSCode Insiders

Versión 0.2.6

• Corregir un error tipográfico

Versión 0.2.5

• Conexión de soporte con Entra ID

Versión 0.2.4

• Actualización de dependencia

Versión 0.2.3

• Actualización de dependencia

Versión 0.2.2

• Elimine una prueba condicional de la operación CREATE agregando RETURN a la descripción de la herramienta write-age-cypher .

Versión 0.2.1

• Se corrige un error en la creación de nodos/bordes

Versión 0.2.0

• Añadir soporte para múltiples gráficos

• Añadir soporte para creación y eliminación de gráficos

• Argumento --graph-name obsoleto

Versión 0.1.8

• Agregar la bandera --allow-write

Versión 0.1.7

• Agregar soporte para Windows

Versión 0.1.6

• Corregir el analizador para valores RETURN

Versión 0.1.5

• Borrador de comunicado

Versión 0.1.4

• Borrador de comunicado

Versión 0.1.3

• Borrador de comunicado

Versión 0.1.2

• Borrador de comunicado

Versión 0.1.1

• Borrador de comunicado

Versión 0.1.0a1

• Borrador de comunicado

Para más información

• Edad de Apache: https://age.apache.org/

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

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

Licencia

Licencia MIT