שרת ה-MCP ל-Postgres, אומת בריצה חיה על Mac אמיתי.

• כלים

  1, נספר בריצה חיה

• אישורי גישה

  לא נדרשים, רק מחרוזת חיבור

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [4]

• מתחזק

  modelcontextprotocol, בארכיון [1][3]

• הורדות

  124 אלף בשבוע האחרון [2]

• רישיון

  MIT [5]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio, כשהוא מכוון למסד נתונים זמני של PostgreSQL 16 שזרענו על ה-Mac הזה לצורך הבדיקה, אף פעם לא לנתונים אמיתיים. השלמנו את לחיצת היד של MCP, קראנו ל-tools/list, ואז ביצענו קריאות query אמיתיות: קריאה מוצלחת אחת של שלוש שורות, וסדרה של כשלים מכוונים כדי ללכוד את נוסח השגיאות המדויק שהשרת מחזיר. טבלת הכלים למטה היא הלכידה הזו, מילה במילה. שני פרטים שאיננו מייפים: השרת ענה ללחיצת היד שלנו בגרסת 2025-06-18 עם גרסת הפרוטוקול הישנה יותר 2024-11-05, והוא לא הדפיס דבר משל עצמו ב-stderr, ולכן השורה שלמטה היא npm שמזהיר אותנו שהחבילה מיושנת, מה שהוא עושה בהתקנה הראשונה ולא בריצות מהמטמון.

npm warn deprecated @modelcontextprotocol/server-postgres@0.6.2: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

tools/call query {"sql": "SELECT book, author, pages FROM reading_log ORDER BY id LIMIT 3"}

[
  {
    "book": "The Mythical Man-Month",
    "author": "Frederick Brooks",
    "pages": 322
  },

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 1 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://yourname@localhost:5432/yourdb"
      ]
    }
  }
}

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://yourname@localhost:5432/yourdb

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://yourname@localhost:5432/yourdb"
      ]
    }
  }
}

Name        PostgreSQL
Command     npx
Arguments   -y @modelcontextprotocol/server-postgres postgresql://yourname@localhost:5432/yourdb

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ PostgreSQL בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלי של השרת זמין ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

3. 03

   בחרו Command (stdio)‎

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שה-Mac שלכם מריץ, לא כתובת אינטרנט שהוא פונה אליה.

4. 04

   הרכיבו את מחרוזת החיבור

   Name: PostgreSQL. Command: npx. Arguments: ‎-y @modelcontextprotocol/server-postgres, אחריו רווח ומחרוזת החיבור שלכם. למחרוזת יש חמישה חלקים: ‎postgresql://‎, המשתמש במסד הנתונים, המארח, הפורט ושם מסד הנתונים, למשל ‎postgresql://yourname@localhost:5432/yourdb. אם לא אתם הקמתם את מסד הנתונים, מי שכן הקים יכול לתת לכם את כל החמישה, וכדאי לבקש ממנו באותה הזדמנות משתמש עם הרשאות קריאה בלבד.

5. 05

   בדקו, ואז הוסיפו

   השאירו את Environment Variables ריק, השרת הזה קורא הכל מהארגומנטים. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, אחד עבור השרת הזה. וכאן החלק שאף אחד לא כותב: השרת לא ניגש למסד הנתונים עד השאילתה האמיתית הראשונה, ולכן מחרוזת חיבור עם שם מסד נתונים שגוי עוברת את הבדיקה הזו בהצלחה. בדיקה שעוברת מוכיחה שהשרת עלה, לא שהוא מצליח להגיע לנתונים שלכם. לחצו Add Server, ואז שאלו אותו משהו בצ׳אט כדי לוודא את החיבור.

6. 06

   השתמשו בו

   הכלי עובד בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בו, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

cannot execute INSERT in a read-only transaction

database "does_not_exist_db" does not exist

relation "books" does not exist

syntax error at end of input

Please provide a database URL as a command-line argument

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: @modelcontextprotocol/server-postgresנקרא בתאריך 2026-08-03

   Latest version 0.6.2, published 2024-12-04, carrying the deprecation notice "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info." License MIT.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   123,984 downloads for the week ending 2026-08-01.

3. [3]

   GitHub: modelcontextprotocol/servers-archivedנקרא בתאריך 2026-08-03

   Archived repository described as "Reference MCP servers that are no longer maintained", last pushed 2025-05-28, per the GitHub API. It holds src/postgres.

4. [4]

   Postgres server source: src/postgres/index.tsנקרא בתאריך 2026-08-03

   Runs BEGIN TRANSACTION READ ONLY before each query and ROLLBACK after, with no flag to disable it: the only command-line argument it reads is the database URL, and it exits when that is missing. Instantiates StdioServerTransport, and serves each table's schema as an MCP resource.

5. [5]

   modelcontextprotocol/servers-archived LICENSE fileנקרא בתאריך 2026-08-03

   MIT, per the GitHub API license endpoint for the repository.

6. [6]

   PyPI: postgres-mcpנקרא בתאריך 2026-08-03

   Version 0.3.0, summary "PostgreSQL Tuning and Analysis Tool".

7. [7]

   pypistats: postgres-mcp recent downloadsנקרא בתאריך 2026-08-03

   106,879 downloads in the last week.

8. [8]

   GitHub: crystaldba/postgres-mcpנקרא בתאריך 2026-08-03

   3,146 stars, MIT licensed, not archived, last pushed 2026-01-22, per the GitHub API. Described as providing "configurable read/write access and performance analysis".

9. [9]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   The official Claude Desktop quickstart and the claude_desktop_config.json shape.

10. [10]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers.

11. [11]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

12. [12]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את PostgreSQL כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.