pickfit

瀏覽MCP 伺服器

Obsidian MCP Server

MCP 伺服器,讓 AI 助理讀寫、搜尋與整理 Obsidian vault。

已在 Linux 上測試

使用

Linux x86_64

需要先準備

  • 執行環境:Node.js 20.19 or newer

這些步驟是在家目錄裡一個已經存在的 work 資料夾裡跑的。請先建立它,再從那裡執行:

mkdir -p "$HOME/work" && cd "$HOME/work"
  1. 全域安裝套件

    npm install -g @smith-and-web/obsidian-mcp-server mcp-remote
在 pickfit 驗證過的原始指令(沙盒裡實際執行的)

僅供查核:裡面是沙盒的家目錄 /home/sbx。

npm install -g @smith-and-web/obsidian-mcp-server mcp-remote
ls ~/.local/bin/ | grep -i -E "obsidian|mcp-remote|mcp"; which obsidian-mcp-server; which mcp-remote; mcp-remote --help
mkdir -p /home/sbx/work/vault && cat > /home/sbx/work/vault/welcome.md <<'EOF'
---
tags: [demo, test]
title: Welcome
---
# Welcome

This is a sample note with searchable content about pickfit verification.

See also [[other-note]] and #inline-tag.

## Section One

Details under section one.
EOF
cat > /home/sbx/work/vault/other-note.md <<'EOF'
# Other Note

Content linking back to [[welcome]] with unique word zyxwvu123.
EOF
ls -la /home/sbx/work/vault/ && cat /home/sbx/work/vault/welcome.md
VAULT_PATH=/home/sbx/work/vault PORT=3001 obsidian-mcp-server
curl http://localhost:3001/health

確認能用

ls ~/.local/bin/ | grep -i -E "obsidian|mcp-remote|mcp"; which obsidian-mcp-server; which mcp-remote; mcp-remote --help

輸出應包含「Usage: mcp-remote」。

先試試這個

mkdir -p "$HOME"/work/vault && cat > "$HOME"/work/vault/welcome.md <<'EOF'
---
tags: [demo, test]
title: Welcome
---
# Welcome

This is a sample note with searchable content about pickfit verification.

See also [[other-note]] and #inline-tag.

## Section One

Details under section one.
EOF
cat > "$HOME"/work/vault/other-note.md <<'EOF'
# Other Note

Content linking back to [[welcome]] with unique word zyxwvu123.
EOF
ls -la "$HOME"/work/vault/ && cat "$HOME"/work/vault/welcome.md
VAULT_PATH="$HOME"/work/vault PORT=3001 obsidian-mcp-server
curl http://localhost:3001/health

加進你的 agent

claude mcp add obsidian-mcp-server -e VAULT_PATH='<VAULT_PATH>' -- mcp-remote http://127.0.0.1:3001/sse
Claude Desktop、Cursor 等用戶端用的 JSON
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "mcp-remote",
      "args": [
        "http://127.0.0.1:3001/sse"
      ],
      "env": {
        "VAULT_PATH": "<VAULT_PATH>"
      }
    }
  }
}

你要填的

  • VAULT_PATH:Obsidian vault 路徑(必填)

VAULT_PATH 要填你自己的值;pickfit 沒有這些值,這裡只是佔位符。

以 VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server 啟動伺服器,再以 mcp-remote http://127.0.0.1:3001/sse 將 MCP 用戶端指向它。

它能做什麼

  • 建立、讀取、更新與刪除筆記
    怎麼使用
    1. 以 VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server 啟動伺服器。
    2. 透過 mcp-remote http://127.0.0.1:3001/sse 連接 MCP 用戶端。
    3. 請助理以筆記路徑(例如 <note>.md)呼叫 read-note 工具。
    已測試
  • 以文字搜尋筆記
    怎麼使用
    1. 以 VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server 啟動伺服器。
    2. 透過 mcp-remote http://127.0.0.1:3001/sse 連接 MCP 用戶端。
    3. 請助理以查詢 <your text> 呼叫 search-vault 工具。
    已測試
  • 管理標籤與 frontmatter 中繼資料
    怎麼使用
    1. 以 VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server 啟動伺服器。
    2. 透過 mcp-remote http://127.0.0.1:3001/sse 連接 MCP 用戶端。
    3. 請助理呼叫 list-tags 工具,查看 vault 中的標籤。
    已測試
  • 依語意搜尋筆記
    未測試

pickfit 測到哪一步

Linux x86_64

  1. 可以安裝
  2. 可以連線
  3. 4 項功能中 3 項可用
  4. 可離線使用

適合用來

  • 讀取筆記內容
  • 建立新筆記
  • 全文搜尋 vault 並顯示上下文
  • 找出連結到某筆記的筆記
  • 列出所有標籤及使用次數

pickfit 怎麼測的

每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證

Linux x86_64

MCP 用戶端成功呼叫工具

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年10月30日
  • 版本 1.12.0

MCP 用戶端透過 stdio 連線,列出 31 個工具,呼叫 read-note 也回傳了結果。

測試機器遇到的差異

  • README: VAULT_PATH=/path/to/your/vault npx @smith-and-web/obsidian-mcp-server and npx -y mcp-remote http://localhost:3001/sse
    測試中: npm install -g @smith-and-web/obsidian-mcp-server mcp-remote,接著以 VAULT_PATH/PORT 執行已安裝的 obsidian-mcp-server;stdio 用戶端/探測透過 mcp-remote http://127.0.0.1:PORT/sse 連線
  • README: no --help/--version documented; server starts in foreground
    測試中: obsidian-mcp-server --help 會啟動 SSE 伺服器而非印出說明;請用 mcp-remote --help 或探測交握來驗證

怎麼看工具卡

縫線
pickfit 親自安裝過這款工具,縫線下方的內容都來自那次測試。沒測過的工具,一律沒有縫線。
已在你的作業系統上驗證
安裝步驟在你選的系統上跑過。「只在 Linux 上執行過」表示還沒在你的系統上跑過。
macOS、Linux 和 Windows在哪裡測過
綠色系統標記:pickfit 在該系統跑過安裝步驟。灰色:README 說支援,但 pickfit 還沒試過。
測試進行到哪一步
能安裝並啟動、主要功能可用、服務有回應、能產生模型輸出。視窗代表桌面應用程式已開啟;插頭代表 MCP 用戶端用過它。標記在測試結果旁邊:展開「為什麼適合、我們怎麼知道」,或在「pickfit 怎麼測的」裡。
視覺檢查
pickfit 看過應用程式的截圖。綠色:畫面正常。黃色加數字:有看起來不對的地方,點開就能看到。灰色虛線:還沒檢查。
已知漏洞
它安裝的套件有沒有已知的高風險或嚴重漏洞(OSV.dev)。綠色:沒有已知漏洞。紅色加數字:有幾個,點開看清單,安裝前先看過。灰色虛線:沒有檢查,不代表安全。
關於這次測試
測試日期,以及測到的版本。
理由的來源
每個推薦理由都依據簡介裡的一個欄位。展開理由就能看到欄位和值。
寶藏
品質高、少有人知。
品質與知名度
兩個分數,滿分都是 100。品質:pickfit 試裝、試用的結果,以及安裝文件和維護狀況。知名度:看星數、下載量和 Hacker News。
已檢查的功能
README 宣傳的主要功能裡,實測通過幾項(綠色)、失敗幾項(紅色)。灰色是沒檢查的,工具卡會說明原因。
未驗證
Fitz 依一般知識提到的知名工具。沒有測試紀錄、沒有步驟、沒有分數。