AGE MCP服务器
Apache AGE MCP服务器
Apache AGE™ 是一个PostgreSQL图形数据库，与PostgreSQL的分布式资产兼容，并利用图形数据结构来分析和使用数据中的关系和模式。
PostgreSQL的Azure数据库 是一种基于开源Postgres数据库引擎的托管数据库服务。
在Azure Database for PostgreSQL中引入对图形数据的支持（预览版）.
目录
先决条件
- Python 3.13及以上版本
- 此模块运行于 psycopg
- 在Azure Database for PostgreSQL实例中启用Apache AGE扩展。登录Azure门户，转到“服务器参数”刀片，在“Azure.extensions”和“shared_preload_librarys”参数中检查“AGE”。有关更多信息，请参阅上面的博客文章。
- 在PostgreSQL数据库中加载AGE扩展。
CREATE EXTENSION IF NOT EXISTS age CASCADE;- 克劳德
下载自 Claude桌面客户端 或者，
brew install claude- Visual Studio Code 内测版
下载自 Visual Studio Code 或者，
brew intall visual-studio-code安装
- 用brew
brew intall rioriost/tap/age_mcp_server
- with 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上
你需要创建一个新的 `claude_desktop_config.json` 在...之下 `%APPDATA%\Claude`.
- macOS上的自制咖啡
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` env变量，或 [安装Azure命令行界面](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) 和 [登录Azure](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli) 使用您的Azure帐户。
保存后 `claude_desktop_config.json`，启动克劳德桌面客户端。
## 与Visual Studio代码一起使用
安装后，\[首选项\]->\[设置\]并输入 `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服务器默认禁止写操作。如果要启用写操作，可以使用 `--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" ] } } }
## 更多信息
- Apache年龄：https://age.apache.org/
- github：https://github.com/apache/age
- 文件：https://age.apache.org/age-manual/master/index.html
## 许可证
MIT许可证