Rioriost Homebrew Age MCP Server

🚀 AGE - MCP - Server

AGE - MCP - Server 是一个与 PostgreSQL 数据库结合使用的服务，借助 AGE 扩展可实现图数据库相关功能。它提供了多种安装方式，支持不同操作系统，通过配置文件可灵活配置服务参数，为用户提供图形界面进行图数据库的操作。

🚀 快速开始

在使用 AGE - MCP - Server 之前，需要完成 PostgreSQL 的安装和 AGE 扩展的启用。

安装 PostgreSQL

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

启用 AGE 扩展

1. 打开 PostgreSQL 数据库。
2. 运行以下 SQL 命令启用 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"
      ]
    }
  }
}

高级用法

AGE - MCP - Server 还提供了图形界面操作示例：

• 查询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.0a1：均为发布候选版本。

更多信息

• Apache AGE: https://age.apache.org/
• GitHub: https://github.com/apache/age
• 官方文档: Apache AGE 文档

📄 许可证

本项目采用 MIT 许可证。