mcpField
M
mcp-psycopg2

mcp-psycopg2

本地服务
github.com/daedalus数据库027 周前更新
代码仓库

关于 mcp-psycopg2

mcp-psycopg2 将 psycopg2 的 PostgreSQL 数据库适配器功能封装为 MCP 服务，供客户端连接和操作数据库。它覆盖事务、游标、COPY、类型注册及大型对象等操作。

主要功能

  1. 01管理数据库连接与事务
  2. 02执行 SQL 并读取结果
  3. 03组合 SQL 与参数
  4. 04注册 JSON、hstore 和复合类型
  5. 05执行 COPY 与大型对象操作
  6. 06查看服务端及会话信息

适用场景

  1. 01通过客户端执行 PostgreSQL 查询
  2. 02控制事务并遍历查询结果
  3. 03批量导入或导出表数据

MCP 相关

作为 MCP 服务，它向 MCP 客户端提供 psycopg2 工具，用于连接 PostgreSQL、执行查询、管理事务及处理数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "daedalus-mcp-psycopg2": {
      "command": "uvx",
      "args": [
        "mcp-psycopg2"
      ]
    }
  }
}
启动命令uvx mcp-psycopg2

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-psycopg20.1.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-psycopg2

提供 psycopg2 PostgreSQL 数据库适配器功能的 MCP 服务。

PyPI Python Ruff

mcp-name: io.github.daedalus/mcp-psycopg2

安装

pip install mcp-psycopg2

使用方法

from mcp_psycopg2 import mcp

# Run the MCP server
mcp.run()

MCP 工具

该服务提供以下用于与 PostgreSQL 数据库交互的工具：

连接管理
  • connect - 创建新的数据库连接
  • close_connection - 关闭现有连接
  • get_connection_info - 获取连接详情
事务管理
  • begin_transaction - 开始新事务
  • commit_transaction - 提交当前事务
  • rollback_transaction - 回滚当前事务
  • set_isolation_level - 设置事务隔离级别
游标操作
  • create_cursor - 创建新游标
  • close_cursor - 关闭游标
  • execute_query - 执行 SQL 查询
  • execute_many - 使用多组参数执行查询
  • fetch_one - 获取一行
  • fetch_many - 获取多行
  • fetch_all - 获取所有剩余行
SQL 组合
  • quote_identifier - 为 SQL 标识符加引号
  • mogrify - 返回绑定参数后的查询字符串
类型注册
  • register_json - 注册 JSON 类型适配器
  • register_hstore - 注册 hstore 类型适配器
  • register_composite - 注册复合类型适配器
COPY 操作
  • copy_from - 将数据从文件复制到表
  • copy_to - 将数据从表复制到文件
  • copy_expert - 执行自定义 COPY 语句
服务端游标
  • create_named_cursor - 创建服务端命名游标
  • scroll_cursor - 滚动浏览游标结果
大对象
  • create_large_object - 创建或打开大对象
  • read_large_object - 从大对象读取
  • write_large_object - 写入大对象
信息
  • get_server_version - 获取 PostgreSQL 服务端版本
  • get_backend_pid - 获取后端进程 ID
  • get_dsn_parameters - 获取连接参数
  • get_notices - 获取数据库通知
  • parse_dsn - 解析连接字符串
  • make_dsn - 创建连接字符串
实用工具
  • cancel_query - 取消当前数据库操作
  • set_session - 设置会话参数
  • list_connections - 列出所有活动连接
  • list_cursors - 列出所有活动游标

开发

git clone https://github.com/daedalus/mcp-psycopg2.git
cd mcp-psycopg2
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。