fotkyBuzalkovi/mcp_postgres/README.md

PostgreSQL MCP server — fotky_buzalkovi

Umožní Claudovi volat tvůj lokální PostgreSQL přímo.

1. Závislosti (jednou)

# Ve venv projektu (nebo globálně)
.\.venv\Scripts\pip install psycopg2-binary mcp

mcp balíček není nutný — server používá čistý stdio JSON-RPC, žádná extra knihovna nepotřeba. Stačí psycopg2-binary.

2. Přidání do Claude Desktop

Otevři (nebo vytvoř) soubor:

%APPDATA%\Claude\claude_desktop_config.json

A přidej do sekce mcpServers:

{
  "mcpServers": {
    "postgres-fotky": {
      "command": "C:\\Users\\vlado\\PycharmProjects\\fotkyBuzalkovi\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\vlado\\PycharmProjects\\fotkyBuzalkovi\\mcp_postgres\\server.py"
      ]
    }
  }
}

3. Restart Claude Desktop

Po uložení config souboru restartuj Claude Desktop. Server se spustí automaticky.

4. Dostupné nástroje

Tool	Popis
pg_query	SELECT dotaz, vrátí JSON (max 200 řádků)
pg_execute	INSERT / UPDATE / DELETE / DDL
pg_list_tables	Seznam tabulek s velikostmi
pg_describe_table	Struktura tabulky (sloupce, indexy)

Přímé otestování

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' | .\.venv\Scripts\python.exe mcp_postgres\server.py