Dbms MCP Server

db-mcp

用于管理和查询PostgreSQL数据库的最小Python MCP服务器。此项目使用存储库模式进行数据库访问，并公开端点以搜索和添加记录到 person 桌子。专为与Claude MCP客户端集成而设计。

*这主要是一个有趣的副项目，在一天内完成，而不是一个生产就绪的MCP服务器，我想看看如何使用Copilot或Claude Desktop（或Cursor）像MCP客户端一样实际交互和调用工具（在这种情况下是一个简单的POSTGRESQL调用），这对我来说是一次有趣的学习经历：）*

______________________________________________________________________

特性

• 通过环境变量集成PostgreSQL
• 用于干净数据库逻辑的存储库模式
• 用于搜索和添加操作的MCP工具端点
• 简单的配置和测试脚本

______________________________________________________________________

入门指南

先决条件

• Python 3.11+
• PostgreSQL服务器正在运行
• Claude MCP客户端（可选）

安装

git clone https://github.com/cruelkratos/dbms-mcp-server.git
cd db-mcp
uv sync

配置

创建一个 .env 项目根目录中的文件：

POSTGRES_DATABASE=postgres
POSTGRES_USER=postgres
POSTGRES_PASSWORD=yourpassword
POSTGRES_HOST=localhost
POSTGRES_PORT=5432

确保数据库中有一个名为的表 person 带列： id, name, age, gender.

确保更新MCP客户端的JSON以连接到此MCP服务器（以下是claude桌面的示例）

{
  "mcpServers": {
    "db_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path\\to\\repo\\db_mcp",
        "run",
        "main.py"
      ]
    }
  }
}

______________________________________________________________________

运行服务器

uv run main.py

______________________________________________________________________

用法

端点公开用于：

• 按姓名查找某人
• 按ID查找某人
• 添加新用户

使用Claude MCP客户端或HTTP请求进行交互。

______________________________________________________________________

示例截图

______________________________________________________________________

项目结构

db_mcp/
├── main.py
├── repository.py
├── server.py
├── tools/
│   ├── controller.py
│   └── dbms.py
├── .env
├── test_db.py
├── test_dbms.py
├── test_mcp.py
└── README.md

______________________________________________________________________

测试

python test_db.py
python test_dbms.py
python test_mcp.py

______________________________________________________________________

许可证

MIT许可证

______________________________________________________________________

鸣谢

MCP文件

由残酷克瑞托斯开发😽