שרת ה-MCP ל-Obsidian, הופעל וכליו נספרו בריצה חיה על Mac אמיתי.

• כלים

  12, נספרו בריצה חיה

• אישורי גישה

  נדרש מפתח API של תוסף Obsidian [7]

• ערוץ תקשורת

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

• מתחזק

  MarkusPfundstein [1][3]

• הורדות

  9.7 אלף בשבוע האחרון ב-PyPI [2]

• רישיון

  MIT [4]

אימות

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

השיטה

הרצנו את השרת עם uvx על גבי stdio, לפי הנתיב המלא ש-which uvx מחזיר, עם מפתח API מדומה ועם ה-SDK של MCP ל-Python מקובע מתחת לגרסה 2. לחיצת היד הושלמה, tools/list החזיר את 12 הכלים המודפסים למטה מילה במילה, ואז ביצענו שתי קריאות כלים אמיתיות. קריאות מאומתות עדיין ממתינות לאישור גישה שאין לנו: מפתח ה-API שמנפיק תוסף הקהילה Local REST API של Obsidian, שגם חייב להיות מותקן ורץ בתוך Obsidian. שתי הקריאות ענו בסירוב התחברות, והראשונה מביניהן היא תוצאת הדוגמה המוצגת כאן, שנלכדה ישירות מהחיבור. שתי הערות על התוצרים למעלה: השרת הזה לא מדפיס באנר משל עצמו, ולכן שתי שורות הבאנר הן יומן הבקשות של ה-SDK שהוא כתב בזמן שענה לנו, והגרסה 1.29.0 שהוא מדווח עליה היא גרסת ה-SDK ולא גרסת החבילה 0.2.2, כי השרת לא מעביר ל-SDK מספר גרסה משל עצמו. שום דבר בעמוד הזה לא טוען שקריאה מאומתת הצליחה.

INFO:mcp.server.lowlevel.server:Processing request of type ListToolsRequest
INFO:mcp.server.lowlevel.server:Processing request of type CallToolRequest

tools/call obsidian_list_files_in_vault {}

Caught Exception. Error: Request failed: HTTPSConnectionPool(host='127.0.0.1', port=27124): Max retries exceeded with url: /vault/ (Caused by NewConnectionError("HTTPSConnection(host='127.0.0.1', port=27124): Failed to establish a new connection: [Errno 61] Connection refused"))

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

כלים

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

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

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

התקנה

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

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

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "--with",
        "mcp<2",
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-plugin-api-key",
        "OBSIDIAN_HOST": "127.0.0.1"
      }
    }
  }
}

claude mcp add obsidian -e OBSIDIAN_API_KEY=your-plugin-api-key -e OBSIDIAN_HOST=127.0.0.1 -- uvx --with 'mcp<2' mcp-obsidian

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "--with",
        "mcp<2",
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-plugin-api-key",
        "OBSIDIAN_HOST": "127.0.0.1"
      }
    }
  }
}

Name                    Obsidian
Command                 uvx
Arguments               --with mcp<2 mcp-obsidian
Environment Variables   OBSIDIAN_API_KEY       your-plugin-api-key

בלי טרמינל

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

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

1. 01

   התקינו את Routines

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

2. 02

   הפעילו את תוסף Obsidian והעתיקו את המפתח שלו

   בתוך Obsidian: Settings, אחר כך Community plugins, אחר כך Browse, והתקינו את Local REST API מאת coddingtonbear. הפעילו אותו, פתחו את Settings, Local REST API והעתיקו את מפתח ה-API שמוצג שם. השאירו את Obsidian פתוחה: השרת מדבר עם התוסף הזה, ולכן Obsidian סגורה פירושה שאין כספת.

3. 03

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

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

4. 04

   בחרו Command (stdio) ומלאו את הטופס

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: Obsidian. Command: uvx. Arguments: ‎--with mcp<2 mcp-obsidian. בשדה Environment Variables הוסיפו את OBSIDIAN_API_KEY עם המפתח שהעתקתם מהתוסף.

5. 05

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

   לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שנים עשר עבור השרת הזה. המספר הזה מוכיח שהשרת רץ; הוא לא מוכיח שהמפתח שלכם נכון, וזה מתברר בשאלה האמיתית הראשונה. אחר כך לחצו Add Server.

6. 06

   השתמשו בו

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

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

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

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

פתרון תקלות

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

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

    @app.list_tools()
     ^^^^^^^^^^^^^^
AttributeError: 'Server' object has no attribute 'list_tools'

    raise ValueError(f"OBSIDIAN_API_KEY environment variable required. Working directory: {os.getcwd()}")
ValueError: OBSIDIAN_API_KEY environment variable required. Working directory: /private/tmp

Caught Exception. Error: Request failed: HTTPSConnectionPool(host='127.0.0.1', port=27124): Max retries exceeded with url: /vault/ (Caused by NewConnectionError("HTTPSConnection(host='127.0.0.1', port=27124): Failed to establish a new connection: [Errno 61] Connection refused"))

שאלות נפוצות

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

מקורות

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

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

1. [1]

   PyPI JSON API: mcp-obsidianנקרא בתאריך 2026-08-03

   Latest version 0.2.2, published 2025-04-01; it requires mcp>=1.1.0 and Python 3.11 or newer.

2. [2]

   PyPI download stats: mcp-obsidianנקרא בתאריך 2026-08-03

   9,728 downloads in the last week and 36,559 in the last month.

3. [3]

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

   4,248 stars and a push dated 2026-05-15 at access time, per the GitHub API.

4. [4]

   mcp-obsidian LICENSE fileנקרא בתאריך 2026-08-03

   MIT License, Copyright (c) 2024 Markus Pfundstein.

5. [5]

   mcp-obsidian READMEנקרא בתאריך 2026-08-03

   The uvx config shape, the plugin requirement, and the defaults: host 127.0.0.1, port 27124.

6. [6]

   mcp-obsidian source: server.pyנקרא בתאריך 2026-08-03

   Runs the MCP Server inside stdio_server(): the server speaks stdio.

7. [7]

   GitHub: coddingtonbear/obsidian-local-rest-apiנקרא בתאריך 2026-08-03

   2,736 stars, MIT, pushed 2026-08-03 at access time. Its README documents the API key location, the 27124 HTTPS port, and the plugin's own MCP endpoint.

8. [8]

   PyPI JSON API: mcp, the Python SDKנקרא בתאריך 2026-08-03

   Version 2.0.0 published 2026-07-28; 1.29.0, the version our run resolved, was published the same day.

9. [9]

   npm registry: obsidian-mcpנקרא בתאריך 2026-08-03

   The folder-reading alternative: version 1.0.6, MIT, and 3,555 downloads for the week ending 2026-08-01 per the npm downloads API.

10. [10]

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

    Its README config passes vault paths straight to the command, so it needs no plugin and no key.

11. [11]

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

    The claude mcp add syntax for local stdio servers, including the -e/--env flag for environment variables.

12. [12]

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

    The mcp.json shape and file locations.

13. [13]

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

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

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