AGE-MCP-сервер

Apache AGE MCP-сервер

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

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

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

Предпосылки

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

Лицензия

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

AGE-MCP-Server

Integrations