AGE-MCP-Server

Name: AGE-MCP-Server
Author: rioriost

@rioriost

代码仓库

关于 AGE-MCP-Server

Apache AGE MCP Server

基本信息

分类

其他

许可证

MIT

运行时

ruby

传输方式

stdio

发布者

rioriost

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "homebrew-age-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is AGE-MCP-Server?

AGE-MCP-Server is an MCP (Model Context Protocol) server that connects AI assistants (Claude, VS Code Insiders) to Apache AGE, a PostgreSQL Graph database. It enables natural language graph queries and operations on Azure Database for PostgreSQL instances.

How to use AGE-MCP-Server?

Install via brew, uv, or pip (Python 3.13+ required). Configure your Claude Desktop or VS Code Insiders settings JSON with the command age_mcp_server and a --pg-con-str argument pointing to your Azure PostgreSQL database. Start the client; write operations are disabled by default—add --allow-write to enable them.

Key features of AGE-MCP-Server

Connects Claude / VS Code to Apache AGE on Azure PostgreSQL
Supports read-only graph queries by default
Optional --allow-write flag for graph mutations
Compatible with Entra ID / Azure CLI authentication
Uses psycopg as the database driver

Use cases of AGE-MCP-Server

List existing graphs and view their schemas
Query graph data using natural language
Create, update, or delete graphs, nodes, and edges
Analyze relationships and patterns in your data

FAQ from AGE-MCP-Server

What does AGE-MCP-Server do?

It is an MCP server that allows AI assistants to interact with Apache AGE, a PostgreSQL graph extension, hosted on Azure Database for PostgreSQL.

How do I install AGE-MCP-Server?

You can install it using Homebrew (brew install rioriost/tap/age_mcp_server), uv (uv add age_mcp_server), or Python pip (pip install age_mcp_server). Requires Python 3.13+.

What dependencies are needed?

An Azure Database for PostgreSQL instance with the Apache AGE extension enabled and loaded, and psycopg. Claude Desktop or VS Code Insiders is required for the client.

Are write operations allowed by default?

No. AGE-MCP-Server prohibits write operations for safety. Use the --allow-write flag in the configuration to enable them.

How do I connect to my database?

Provide a --pg-con-str argument with host, port, dbname, user, and optionally password. For Entra ID, omit password and set the PGPASSWORD environment variable or install and sign into the Azure CLI.