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 許可證。