mcp-psycopg2

mcp-psycopg2

psycopg2 PostgreSQL データベースアダプターの機能を公開する MCP サーバーです。

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 - 1 行を取得します
• 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/