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를 시작합니다.

서버에 그래프를 보여주세요 $FROM\_AGEFREIGHTER의 그래프 스키마를 보여주세요$ 고객을 선택하여 구매 금액을 계산합니다. Lisa보다 더 많이 구매하는 다른 고객을 찾으세요 $좋습니다. MCP\_Test라는 이름의 새 그래프를 만들어 주세요.$ 속성 이름=Rio, 나이=52를 갖는 'Person'이라는 레이블이 붙은 노드를 만듭니다. '회사'라는 레이블이 붙은 또 다른 노드를 만들어주세요. 속성은 name=Microsoft입니다. "Rio는 Microsoft에서 일합니다"라는 관계를 넣어줄 수 있나요? $그래프 ��제, MCP\_Test$

윈도우의 클로드

Visual Studio Code와 함께 사용

설치 후 [환경설정]->[설정]에서 [검색 설정]에 mcp 입력하세요.

환경 설정의 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 모드로 전환합니다.

VSCode 에이전트

이제 Visual Studio Code를 통해 그래프 데이터를 조작해 보세요!

VSCode 에이전트

쓰기 작업

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(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 라이센스

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Apache AGE 그래프 데이터베이스와 자연어 상호작용을 제공하는 MCP 서버로, 사용자는 Claude AI를 통해 PostgreSQL에서 그래프 데이터를 쿼리하고, 시각화하고, 조작할 수 있습니다.

Related MCP Servers

Neo4j MCP Server
ujjalcal
-
security
F
license
-
quality
An MCP server that enables graph database interactions with Neo4j, allowing users to access and manipulate graph data through natural language commands.
Last updated -
Python
Yazdani-Supabase-MCP Server
byazdani9
-
security
A
license
-
quality
An MCP server that enables natural language querying of Supabase PostgreSQL databases using Claude 3.7, allowing users to inspect schemas, execute SQL, manage migrations, and convert natural language to SQL queries.
Last updated -
Python
MIT License
Database Tools for Claude AI
elber-code
A
security
F
license
A
quality
MCP server that allows Claude AI to interact directly with MySQL databases, enabling query execution and table information retrieval through natural language.
Last updated -
1
6
3
JavaScript
IcebergMCP
ryft-io
-
security
-
license
-
quality
An MCP server that enables natural language interaction with Apache Iceberg data lakehouses, allowing users to query table metadata, schemas, and properties through Claude, Cursor, or other MCP clients.
Last updated -
31
Python
Apache 2.0

View all related MCP servers

AGE-MCP-Server