AGE-MCP-Server

AGE-MCP-Server

site icon
2025.04.14 1
Python图形数据库管理开发工具集成数据库开发效率
AGE-MCP-Server 是一个基于 Apache AGE 的 PostgreSQL 图形数据库管理工具,主要用于与 Azure Database for PostgreSQL 集成,支持图形数据的查询和管理。它提供了与 Claude 和 Visual Studio Code 的集成,使得开发者可以更方便地操作和管理图形数据库。
View on GitHub

Overview

基本能力

产品定位

AGE-MCP-Server 是一个用于管理 Apache AGE 图形数据库的工具,特别适用于与 Azure Database for PostgreSQL 集成的场景。

核心功能

  1. 图形数据库管理:支持对 Apache AGE 图形数据库的查询和管理。
  2. 多工具集成:支持与 Claude 和 Visual Studio Code 集成,提供便捷的操作界面。
  3. 安全控制:默认禁止写操作,可通过 --allow-write 参数启用。
  4. 多平台支持:支持 macOS、Windows 和 Linux 平台。

适用场景

  1. 图形数据分析:适用于需要分析图形数据关系的场景。
  2. 开发工具集成:适用于开发者通过 Claude 或 Visual Studio Code 进行数据库操作。
  3. Azure 数据库管理:适用于在 Azure Database for PostgreSQL 上管理图形数据的场景。

工具列表

  1. Claude:用于图形数据库的查询和管理。
  2. Visual Studio Code:通过插件支持图形数据库的操作。

常见问题解答

  1. 如何启用写操作?:使用 --allow-write 参数。
  2. 如何集成 Claude?:通过修改 claude_desktop_config.json 文件配置。
  3. 如何集成 Visual Studio Code?:通过修改 settings.json 文件配置。

使用教程

使用依赖

  1. Python 3.13 及以上版本
  2. psycopg 库
  3. Apache AGE 扩展:在 Azure Database for PostgreSQL 实例中启用。
CREATE EXTENSION IF NOT EXISTS age CASCADE;
  1. Claude 或 Visual Studio Code

安装教程

使用 Homebrew

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

使用 uv

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

使用 Python venv (macOS/Linux)

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

使用 Python venv (Windows)

mkdir your_project
cd your_project
python -m venv venv
.\venv\Scripts\activate
python -m pip install age-mcp-server

调试方式

  1. 启动 AGE-MCP-Server:通过 Claude 或 Visual Studio Code 配置启动。
  2. 检查日志:查看运行日志以确认服务是否正常启动。
  3. 测试查询:通过工具执行简单的图形查询以验证功能。

许可证

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