AGE-MCP-Server
Apache AGE MCP Server
Apache AGE™ is a PostgreSQL Graph database compatible with PostgreSQL's distributed assets and leverages graph data structures to analyze and use relationships and patterns in data.
Azure Database for PostgreSQL is a managed database service that is based on the open-source Postgres database engine.
Introducing support for Graph data in Azure Database for PostgreSQL (Preview).
Table of Contents
- Prerequisites
- Install
- Usage
- Write Operations
- Release Notes
- For More Information
- License
Prerequisites
Python 3.13 and above
This module runs on psycopg
Enable the Apache AGE extension in your Azure Database for PostgreSQL instance. Login Azure Portal, go to 'server parameters' blade, and check 'AGE" on within 'azure.extensions' and 'shared_preload_libraries' parameters. See, above blog post for more information.
Load the AGE extension in your PostgreSQL database.
CREATE EXTENSION IF NOT EXISTS age CASCADE;
Claude Download from Claude Desktop Client or,
brew install claude
For configuration, see Add the Filesystem MCP Server.
Install
with brew
brew tap rioriost/age-mcp-server
brew install age-mcp-server
with uv
uv init your_project
cd your_project
uv venv
source .venv/bin/activate
uv add age-mcp-server
with python venv on macOS / Linux
mkdir your_project
cd your_project
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install age-mcp-server
with python venv on Windows
mkdir your_project
cd your_project
python -m venv venv
.\venv\Scripts\activate
python -m pip install age-mcp-server
Usage
Homebrew installs age-mcp-server into $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",
]
}
}
}
On 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",
]
}
}
}
On 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",
]
}
}
}
After saving claude_desktop_config.json, start Claude Desktop Client.
Write Operations
AGE-MCP-Server prohibits write operations by default for safety. If you want to enable write operations, you can use the --allow-write flag.
{
"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"
]
}
}
}
Release Notes
0.2.3 Release
0.2.2 Release
- Drop a conditional test of
CREATE operation by adding RETURN to the description for write-age-cypher tool.
0.2.1 Release
- Fix a bug in node/edge creation
0.2.0 Release
- Add multiple graph support
- Add graph creation and deletion support
- Obsolete
--graph-name argument
0.1.8 Release
0.1.7 Release
0.1.6 Release
- Fix parser for
RETURN values
0.1.5 Release
0.1.4 Release
0.1.3 Release
0.1.2 Release
0.1.1 Release
0.1.0a1 Release
For More Information
License
MIT License
