AGE-MCP-서버

Apache AGE MCP 서버

Apache AGE™ 는 PostgreSQL의 분산 자산과 호환되는 PostgreSQL 그래프 데이터베이스이며 그래프 데이터 구조를 활용하여 데이터의 관계와 패턴을 분석하고 사용합니다.

Azure Database for PostgreSQL은 오픈 소스 Postgres 데이터베이스 엔진을 기반으로 하는 관리형 데이터베이스 서비스입니다.

Azure Database for PostgreSQL에서 Graph 데이터에 대한 지원을 소개합니다(미리 보기) .

필수 조건

Python 3.13 이상
이 모듈은 psycopg 에서 실행됩니다.
Azure Database for PostgreSQL 인스턴스에서 Apache AGE 확장을 활성화하세요. Azure Portal에 로그인하고 '서버 매개변수' 블레이드로 이동하여 'azure.extensions' 및 'shared_preload_libraries' 매개변수에서 'AGE'를 활성화하세요. 자세한 내용은 위 블로그 게시물을 참조하세요.
PostgreSQL 데이터베이스에 AGE 확장 프로그램을 로드합니다.

지엑스피1

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

macOS / Linux에서 Python venv 사용

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

Windows에서 Python venv 사용

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

Claude와 함께 사용

macOS에서는 claude_desktop_config.json``~/Library/Application Support/Claude/ 에 있습니다.
Windows에서는 %APPDATA%\Claude 아래에 새 claude_desktop_config.json 을 만들어야 합니다.
macOS에서 Homebrew 사용

Homebrew는 $PATH에 age-mcp-server 설치합니다.

{
  "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 / 파이썬 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"
            ]
            }
        }
    }
}

그러면 AGE MCP 서버가 start 됩니다.

채팅 창을 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.9 릴리스

종속성 업데이트

0.2.8 릴리스

VSCode(Stable)에 대한 지원 추가

0.2.7 릴리스

VSCode Insiders에 대한 지원 추가

0.2.6 릴리스

오타 수정

0.2.5 릴리스

Entra ID를 통한 연결 지원

0.2.4 릴리스

종속성 업데이트

0.2.3 릴리스

종속성 업데이트

0.2.2 릴리스

write-age-cypher 도구에 대한 설명에 RETURN 추가하여 CREATE 작업에 대한 조건부 테스트를 삭제합니다.

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 릴리스

초안 발표

더 많은 정보를 원하시면

아파치 AGE: https://age.apache.org/
GitHub : https://github.com/apache/age
문서 : https://age.apache.org/age-manual/master/index.html

특허

MIT 라이센스

AGE-MCP-Server

Integrations