AGE-MCP-Server 中文文档

年龄许可信息

• MIT 许可证

先决条件

安装 PostgreSQL

• 操作系统要求：
  • Windows: PostgreSQL 官方下载页面
  • macOS: 使用 Homebrew 安装：brew install postgresql
  • Linux: 根据发行版安装，例如 Debian/Ubuntu：sudo apt-get install postgresql postgresql-contrib

启用 AGE 扩展

1. 打开 PostgreSQL 数据库。
2. 运行以下命令启用 AGE 扩展：

   CREATE EXTENSION age;
   

安装方法

使用 brew（仅限 macOS）

brew install age-mcp-server

使用 uv

1. 下载并安装 UV：UV 官方下载页面
2. 启动 UV 并运行以下命令：

   uv age-mcp-server
   

使用 Python 虚拟环境

pip install age-mcp-server

使用说明

配置文件位置

• Windows: C:\Users\<Username>\AppData\Local\Claude 2\mcp-server\config.json
• macOS/Linux: ~/.config/Claude 2/mcp-server/config.json

示例配置（config.json）

{
  "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"
      ]
    }
  }
}

图形界面操作示例

• 查询1: 显示所有客户及其购买金额。
• 查询2: 计算特定客户的总购买金额。
• 查询3: 查找购买金额超过 Lisa 的其他客户。
• 查询4: 创建新图 MCP_Test。
• 查询5: 添加节点和关系。

图形界面截图

• Windows:

写入操作

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

• 更新依赖项。

版本 0.2.2

• 在 CREATE 操作描述中添加 RETURN 条件测试。

版本 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
• 官方文档: Apache AGE 文档