AGE-MCP-Server

Apache AGE MCP Server

Apache AGE™ 是一个与 PostgreSQL 分布式资产兼容的图数据库，利用图数据结构分析和使用数据中的关系和模式。

Azure Database for PostgreSQL 是一个基于开源 Postgres 数据库引擎的托管数据库服务。

在 Azure Database for PostgreSQL 中引入对图数据的支持（预览版）.

目录

• 先决条件
• 安装
• 与 Claude 一起使用
• 与 Visual Studio Code Insiders 一起使用
• 写操作
• 发布说明
• 更多信息
• 许可证

先决条件

• Python 3.13 及以上版本
• 该模块运行在 psycopg 上
• 在您的 Azure Database for PostgreSQL 实例中启用 Apache AGE 扩展。登录 Azure 门户，转到“服务器参数”页面，并在“azure.extensions”和“shared_preload_libraries”参数中勾选“AGE”。更多信息请参阅上述博客文章。
• 在您的 PostgreSQL 数据库中加载 AGE 扩展。

CREATE EXTENSION IF NOT EXISTS age CASCADE;

• Claude 从 Claude 桌面客户端 下载，或

brew install claude

• Visual Studio Code Insiders 从 Visual Studio Code 下载，或

brew install visual-studio-code

安装

• 使用 brew

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

• 使用 uv

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 将 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 / Python 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 桌面客户端。

与 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 Server。

将聊天窗口切换到 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 发布

• 通过为 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 发布

• 草稿发布

更多信息

• Apache AGE : https://age.apache.org/
• GitHub : https://github.com/apache/age
• 文档 : https://age.apache.org/age-manual/master/index.html

许可证

MIT 许可证