Rioriost Homebrew Age MCP Server

🚀 AGE-MCP-Server 中文文档

本项目提供 AGE-MCP-Server 的相关信息，包括安装、使用、配置等内容，帮助用户快速上手使用该服务器。

🚀 快速开始

在使用 AGE-MCP-Server 前，需完成一些先决条件的配置，如安装 PostgreSQL 并启用 AGE 扩展，之后可选择适合自己系统的安装方法进行安装。

✨ 主要特性

• 支持多图，具备图的创建和删除功能。
• 支持 Windows、macOS 和 Linux 等多种操作系统。
• 可通过配置文件灵活配置服务器。
• 默认禁止写入操作，保障数据安全。

📦 安装指南

先决条件

安装 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.1

• 发布候选版本。

版本 0.1.0a1

• 发布候选版本。

更多信息

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

📄 许可证

本项目采用 MIT 许可证。