AGE-MCP-сервер

Apache AGE MCP-сервер

Apache AGE™ — это графовая база данных PostgreSQL, совместимая с распределенными активами PostgreSQL и использующая графовые структуры данных для анализа и использования взаимосвязей и закономерностей в данных.

База данных Azure для PostgreSQL — это управляемая служба базы данных, основанная на ядре базы данных Postgres с открытым исходным кодом.

Представляем поддержку графических данных в базе данных Azure для PostgreSQL (предварительная версия) .

Оглавление

• Предпосылки

• Установить

• Использование с Клодом

• Использование с Visual Studio Code Insiders

• Операции записи

• Заметки о выпуске

• Для получения дополнительной информации

• Лицензия

Related MCP server: Neo4j GraphRAG MCP Server

Предпосылки

• Python 3.13 и выше

• Этот модуль работает на psycopg

• Включите расширение Apache AGE в экземпляре базы данных Azure для PostgreSQL. Войдите в портал Azure, перейдите в колонку «параметры сервера» и проверьте «AGE» в параметрах «azure.extensions» и «shared_preload_libraries». Дополнительные сведения см. в сообщении блога выше.

• Загрузите расширение AGE в вашу базу данных PostgreSQL.

CREATE EXTENSION IF NOT EXISTS age CASCADE;

• Claude Загрузите с помощью Claude Desktop Client или,

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

• с python venv на macOS / Linux

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

• с python venv на Windows

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 вам необходимо создать новый claude_desktop_config.json в %APPDATA%\Claude .

• Homebrew на macOS

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

Затем вы увидите start запуска сервера AGE MCP.

Переключить окно чата в режим 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.10 Выпуск

• Обновление зависимости

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 Выпуск

• Удалите условную проверку операции CREATE , добавив RETURN в описание инструмента write-age-cypher .

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

Лицензия

Лицензия Массачусетского технологического института