AGE-MCP-Server

基本能力

产品定位

AGE-MCP-Server 是一个用于管理和操作 PostgreSQL 图形数据库的工具，特别适用于 Azure Database for PostgreSQL 中的图形数据处理。

核心功能

1. 图形数据查询：支持复杂的图形数据查询操作。
2. 图形数据管理：支持创建、删除图形数据。
3. 多图形支持：支持多个图形的操作和管理。
4. 安全控制：默认禁止写操作，可通过 --allow-write 标志启用。

适用场景

1. 图形数据分析：用于分析和查询图形数据中的关系和模式。
2. 数据库管理：用于管理和操作 PostgreSQL 中的图形数据。
3. 开发测试：用于开发和测试图形数据库应用。

工具列表

1. age-mcp-server：主服务工具，用于启动和管理图形数据库服务。
2. Claude Desktop Client：用于与 age-mcp-server 交互的桌面客户端。

常见问题解答

1. 如何启用写操作？：使用 --allow-write 标志启动服务。
2. 如何配置 Claude Desktop Client？：在 claude_desktop_config.json 中配置服务参数。

使用教程

使用依赖

1. Python 3.13 及以上版本
2. psycopg 库
3. Apache AGE 扩展：在 Azure Database for PostgreSQL 实例中启用。

CREATE EXTENSION IF NOT EXISTS age CASCADE;

1. Claude Desktop Client

brew install claude

安装教程

1. 使用 Homebrew 安装

brew tap rioriost/age-mcp-server
brew install age-mcp-server

1. 使用 uv 安装

uv init your_project
cd your_project
uv venv
source .venv/bin/activate
uv add age-mcp-server

1. 使用 Python venv 安装

mkdir your_project
cd your_project
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install age-mcp-server

调试方式

1. 启动服务

{
  "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",
      ]
    }
  }
}

1. 启用写操作

{
  "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"
      ]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。