Managed Db MCP

托管DB MCP服务器

一个MCP（模型上下文协议）服务器，通过托管数据库API提供管理PostgreSQL数据库的工具。

概述

此MCP服务器将托管数据库API公开为Claude Code和其他兼容MCP的客户端可以使用的工具。它允许您：

• 创建和管理独立的PostgreSQL数据库项目
• 执行迁移并使用RLS策略创建表
• 备份和还原数据库
• 管理API密钥和身份验证
• 监控项目运行状况

安装

选项1：使用紫外线（推荐）

紫外线 是一个快速的Python包安装程序，可以自动管理依赖关系：

# uv will automatically install dependencies when running the server
uv pip install -r requirements.txt

选项2：使用pip

1. 安装MCP Python SDK：

# The MCP SDK may need to be installed from source
pip install mcp httpx

1. 设置API基本URL（可选）：

export MANAGED_DB_API_URL=http://localhost:8080/api

备注：如果安装时遇到问题 mcp 包，您可能需要从官方存储库安装它，或者等待它发布到PyPI。一旦MCP SDK可用，服务器就可以使用了。

使用Claude代码

将此MCP服务器添加到您的Claude Code配置中：

使用npx（推荐）

编辑 ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "managed-db": {
      "command": "python",
      "args": ["/path/to/managed-db/services/mcp-server/server.py"],
      "env": {
        "MANAGED_DB_API_URL": "http://localhost:8080/api"
      }
    }
  }
}

使用紫外线（替代）

{
  "mcpServers": {
    "managed-db": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/managed-db/services/mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "MANAGED_DB_API_URL": "http://localhost:8080/api"
      }
    }
  }
}

可用工具

项目管理

• create_project -创建新的托管数据库项目

- 创建具有所有者/服务/匿名角色的隔离数据库 - 为即时REST部署PostgREST容器API - 生成JWT密钥和API密钥

• list_projects -列出所有项目

• get_project -获取详细的项目信息，包括连接详细信息

• delete_project -删除项目（软删除或硬删除）

• rotate_project_keys -旋转JWT密钥和API密钥

• get_project_health -检查项目数据库和PostgREST状态

数据库操作

• create_table -创建一个包含列、索引和RLS策略的表

• run_migration -执行任意SQL迁移

备份和恢复

• backup_project -创建pg_dump备份

• restore_project -从备份工件还原

示例用法

配置后，您可以在Claude Code中使用这些工具：

User: Create a new database project called "Analytics Dashboard"

Claude: [Uses create_project tool]
✅ Project created successfully!
ID: abc-123-def
Database: proj_analytics_dashboard
Connection URI: postgresql://proj_analytics_dashboard_owner:...@localhost:5432/proj_analytics_dashboard
REST API URL: https://db.example.com/p/abc-123-def/rest

User: Create a users table with email and created_at columns

Claude: [Uses create_table tool with the project ID]
✅ Table 'users' created successfully!

配置

环境变量

• MANAGED_DB_API_URL -托管数据库API的基本URL（默认值： http://localhost:8080/api)

发展

直接运行服务器：

python server.py

服务器使用MCP协议通过stdin/stdout进行通信。

需求

• Python 3.10+
• mcp>=1.0.0
• httpx>=0.26.0
• 正在运行托管数据库API服务

建筑

MCP服务器充当Claude Code和托管数据库API之间的桥梁：

Claude Code  MCP Server  Managed DB API  PostgreSQL

每个MCP工具向相应的API端点发出HTTP请求，并返回格式化的响应。