AGE-MCP-服务器

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 桌面客户端下载或者，

brew install claude

Visual Studio Code Insiders 从Visual Studio Code下载或

brew intall visual-studio-code

安装

与酿造

brew tap rioriost/age-mcp-server
brew install age-mcp-server

带紫外线

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。

与 Visual Studio Code 一起使用

安装后，[偏好设置]->[设置]，在[搜索设置]中输入mcp 。

编辑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模式。

现在，您可以通过 Visual Studio Code 处理图形数据！

写入操作

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.9 版本

依赖关系更新

0.2.8 版本

添加对 VSCode（稳定版）的支持

0.2.7 版本

添加对 VSCode Insiders 的支持

0.2.6 版本

修正拼写错误

0.2.5 版本

支持与Entra ID连接

0.2.4 版本

依赖关系更新

0.2.3 版本

依赖关系更新

0.2.2 版本

通过在write-age-cypher工具的描述中添加RETURN来删除CREATE操作的条件测试。

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 版本

草稿发布

执照

MIT 许可证

AGE-MCP-Server

Integrations