MCP 服务器

AGE-MCP-Server

一个 MCP 服务器，通过 Claude AI 提供与 Apache AGE 图数据库的自然语言交互，允许用户在 PostgreSQL 中查询、可视化和操作图数据。

README

AGE-MCP-Server

Apache AGE MCP 服务器

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

Visual Studio Code Insiders 从 Visual Studio Code 下载，或者

brew intall visual-studio-code

安装

使用 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

与 Claude 一起使用

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

如果您需要隐藏密码或使用 Entra ID，您可以如下设置 --pg-con-str。

{
  "mcpServers": {
    "age-manager": {
        ...
        "--pg-con-str",
        "host=your_server.postgres.database.azure.com port=5432 dbname=postgres user=your_username",
        ...
      ]
    }
  }
}

并且，您需要设置 PGPASSWORD 环境变量，或者安装 Azure CLI 并使用您的 Azure 帐户登录 Azure。

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

Show me graphs on the server Show me a graph schema of FROM_AGEFREIGHTER Pick up a customer and calculate the amount of its purchase. Find another customer buying more than Lisa OK. Please make a new graph named MCP_Test Make a node labeled 'Person' with properties, name=Rio, age=52 Please make an another node labeled 'Company' with properties, name=Microsoft Can you put a relation, "Rio WORK at Microsoft"? Delete the graph, MCP_Test

Claude on Windows

与 Visual Studio Code 一起使用

安装后，[首选项]->[设置] 并输入 mcp 以 [搜索设置]。

MCP Settings in Preferences

编辑 settings.json 如下：

{
    "mcp": {
        "inputs": [],
        "servers": {
            "age-manager": {
            "command": "/Users/your_user_name/.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",
                "--debug"
            ]
            }
        }
    }
}

然后，您将看到 start 以启动 AGE MCP 服务器。

将聊天窗口切换到 agent 模式。

VSCode Agent

现在，您可以通过 Visual Studio Code 使用您的图数据了！

VSCode Agent

写入操作

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