使用
Linux x86_64
需要先準備
- 執行環境:
Node.js 20.19 or newer
這些步驟是在家目錄裡一個已經存在的 work 資料夾裡跑的。請先建立它,再從那裡執行:
mkdir -p "$HOME/work" && cd "$HOME/work"全域安裝套件
npm install -g @smith-and-web/obsidian-mcp-server mcp-remote
在 pickfit 驗證過的原始指令(沙盒裡實際執行的)
僅供查核:裡面是沙盒的家目錄 /home/sbx。
npm install -g @smith-and-web/obsidian-mcp-server mcp-remotels ~/.local/bin/ | grep -i -E "obsidian|mcp-remote|mcp"; which obsidian-mcp-server; which mcp-remote; mcp-remote --helpmkdir -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.mdVAULT_PATH=/home/sbx/work/vault PORT=3001 obsidian-mcp-servercurl 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.mdVAULT_PATH="$HOME"/work/vault PORT=3001 obsidian-mcp-servercurl http://localhost:3001/health加進你的 agent
claude mcp add obsidian-mcp-server -e VAULT_PATH='<VAULT_PATH>' -- mcp-remote http://127.0.0.1:3001/sseClaude 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 用戶端指向它。
它能做什麼
- 建立、讀取、更新與刪除筆記已測試
怎麼使用
- 以
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server啟動伺服器。 - 透過
mcp-remote http://127.0.0.1:3001/sse連接 MCP 用戶端。 - 請助理以筆記路徑(例如 <note>.md)呼叫 read-note 工具。
- 以
- 以文字搜尋筆記已測試
怎麼使用
- 以
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server啟動伺服器。 - 透過
mcp-remote http://127.0.0.1:3001/sse連接 MCP 用戶端。 - 請助理以查詢 <your text> 呼叫 search-vault 工具。
- 以
- 管理標籤與 frontmatter 中繼資料已測試
怎麼使用
- 以
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server啟動伺服器。 - 透過
mcp-remote http://127.0.0.1:3001/sse連接 MCP 用戶端。 - 請助理呼叫 list-tags 工具,查看 vault 中的標籤。
- 以
- 依語意搜尋筆記未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 3 項可用
- 可離線使用
適合用來
- 讀取筆記內容
- 建立新筆記
- 全文搜尋 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 或探測交握來驗證