AGE-MCP-Server

Apache AGE MCP 服务器

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

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

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

目录

• 先决条件
• 安装
• 使用
• 写操作
• 发行说明
• 更多信息
• 许可

先决条件

• 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

关于配置，请参见 添加文件系统 MCP 服务器。

安装

• 使用 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

使用

• 在 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 桌面客户端。

写操作

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.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 许可证