AGE-MCP-服务器

Python

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。

在服务器上显示图表展示 FROM_AGEFREIGHTER 的图表模式接一名顾客并计算其购买金额。找到另一位购买量超过 Lisa 的顾客好的。请创建一个名为 MCP_Test 的新图表创建一个名为“Person”的节点，其属性为 name=Rio、age=52 请创建另一个标记为“公司”的节点，其属性为名称 = Microsoft 你能建立“Rio 在微软工作”的关系吗？删除图表 MCP_Test

Windows 上的 Claude

与 Visual Studio Code 一起使用

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

首选项中的 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模式。

VSCode 代理

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

VSCode 代理

写入操作

AGE-MCP-Server 出于安全考虑默认禁止写入操作。如需启用写入操作，可以使用--allow-write参数。

发行说明

0.2.10 版本

依赖关系更新

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