English Français العربية

io.github.daedalus/mcp-psycopg2

Official registry Data and databases

MCP server exposing psycopg2 PostgreSQL database adapter functionality

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-psycopg2
Claude Code 
claude mcp add mcp-psycopg2 -- uvx mcp-psycopg2==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-psycopg2": {
            "command": "uvx",
            "args": [
                "mcp-psycopg2==0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-psycopg2
  2. Install
  3. Usage
  4. MCP Tools
  5. Development

mcp-psycopg2

MCP server exposing psycopg2 PostgreSQL database adapter functionality.

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

Install

pip install mcp-psycopg2

Usage

from mcp_psycopg2 import mcp

# Run the MCP server
mcp.run()

MCP Tools

The server exposes the following tools for interacting with PostgreSQL databases:

Connection Management
  • connect - Create a new database connection
  • close_connection - Close an existing connection
  • get_connection_info - Get connection details
Transaction Management
  • begin_transaction - Start a new transaction
  • commit_transaction - Commit the current transaction
  • rollback_transaction - Rollback the current transaction
  • set_isolation_level - Set transaction isolation level
Cursor Operations
  • create_cursor - Create a new cursor
  • close_cursor - Close a cursor
  • execute_query - Execute a SQL query
  • execute_many - Execute a query with multiple parameter sets
  • fetch_one - Fetch one row
  • fetch_many - Fetch multiple rows
  • fetch_all - Fetch all remaining rows
SQL Composition
  • quote_identifier - Quote an SQL identifier
  • mogrify - Return query string after parameter binding
Type Registration
  • register_json - Register JSON type adapter
  • register_hstore - Register hstore type adapter
  • register_composite - Register composite type adapter
COPY Operations
  • copy_from - Copy data from file to table
  • copy_to - Copy data from table to file
  • copy_expert - Execute custom COPY statement
Server-Side Cursors
  • create_named_cursor - Create a server-side named cursor
  • scroll_cursor - Scroll through cursor results
Large Objects
  • create_large_object - Create or open a large object
  • read_large_object - Read from a large object
  • write_large_object - Write to a large object
Information
  • get_server_version - Get PostgreSQL server version
  • get_backend_pid - Get backend process ID
  • get_dsn_parameters - Get connection parameters
  • get_notices - Get database notices
  • parse_dsn - Parse a connection string
  • make_dsn - Create a connection string
Utility
  • cancel_query - Cancel the current database operation
  • set_session - Set session parameters
  • list_connections - List all active connections
  • list_cursors - List all active cursors

Development

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/

Frequently asked questions

What is io.github.daedalus/mcp-psycopg2?

MCP server exposing psycopg2 PostgreSQL database adapter functionality

How do I install io.github.daedalus/mcp-psycopg2?

It runs on your machine. In Claude Code: claude mcp add mcp-psycopg2 -- uvx mcp-psycopg2==0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.daedalus/mcp-psycopg2 need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.daedalus/mcp-psycopg2 open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.daedalus/mcp-psycopg2?

It is published by daedalus. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.