Skip to main content

Apache AGE MCP Server

Project description

AGE-MCP-Server

License Python

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

  • 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;
brew install claude

For configuration, see Add the Filesystem MCP Server.

Install

  • with brew
brew tap 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

  • brew on macOS claude_desktop_config.json is located in ~/Library/Application Support/Claude/.

Add the server to your claude_desktop_config.json as followings

{
  "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"
        "--graph-name",
        "FROM_AGEFREIGHTER",
      ]
    }
  }
}
  • uv / Pyhon venv
{
  "mcpServers": {
    "age-manager": {
      "command": "~/.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"
        "--graph-name",
        "FROM_AGEFREIGHTER",
      ]
    }
  }
}

After saving claude_desktop_config.json, start Claude Desktop Client.

Show me a graph schema Can you pick up a customer and calculate the sum of purchases? Can you find another customer buying more than Lisa?

Release Notes

0.1.2 Release

  • Draft release

0.1.1 Release

  • Draft release

0.1.0a1 Release

  • Draft release

For More Information

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

age_mcp_server-0.1.2.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

age_mcp_server-0.1.2-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file age_mcp_server-0.1.2.tar.gz.

File metadata

  • Download URL: age_mcp_server-0.1.2.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.6

File hashes

Hashes for age_mcp_server-0.1.2.tar.gz
Algorithm Hash digest
SHA256 05a2bc50dd30eb5e627c65bd6c86a96a5e8b887747120e581fd0d3dc1f216b96
MD5 49d9bb56adda0cb92cd713d14e8b2a9f
BLAKE2b-256 2f29950655a7c49f14ef84e31d6404682c390f826686138a929d007e579be333

See more details on using hashes here.

File details

Details for the file age_mcp_server-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for age_mcp_server-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e42a2171a6c9ef94bc43752a9a734f2f8ba39033b85d2f1fb43c9b158315515e
MD5 9c7c8143a860b802856edc77aba18adf
BLAKE2b-256 e8d725617afdb5f9142dd58023e67f5cd15957da064065f2531fc6fb91e45094

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page