AGE-MCP-Server

Apache AGE MCP Server

Apache AGE™ 是一个 PostgreSQL 图数据库，它与 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 Desktop Client 下载，或者

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 / 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",
      ]
    }
  }
}

保存 claude_desktop_config.json 后，启动 Claude Desktop Client。

写入操作

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.3 Release

• 依赖更新

0.2.2 Release

• 通过向 write-age-cypher 工具的描述添加 RETURN，删除对 CREATE 操作的条件测试。

0.2.1 Release

• 修复节点/边创建中的错误

0.2.0 Release

• 添加多图支持
• 添加图创建和删除支持
• 废弃 --graph-name 参数

0.1.8 Release

• 添加 --allow-write 标志

0.1.7 Release

• 添加 Windows 支持

0.1.6 Release

• 修复 RETURN 值的解析器

0.1.5 Release

• 草稿发布

0.1.4 Release

• 草稿发布

0.1.3 Release

• 草稿发布

0.1.2 Release

• 草稿发布

0.1.1 Release

• 草稿发布

0.1.0a1 Release

• 草稿发布

更多信息

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

许可证

MIT 许可证