使用
Linux x86_64
透過 uv 安裝 markdown-vault-mcp
uv tool install "markdown-vault-mcp"
確認能用
markdown-vault-mcp --help 2>&1輸出應包含「Usage: markdown-vault-mcp」。
加進你的 agent
claude mcp add markdown-vault-mcp -- markdown-vault-mcp serveClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "markdown-vault-mcp",
"args": [
"serve"
]
}
}
}將 MARKDOWN_VAULT_MCP_SOURCE_DIR 設為你的筆記資料夾,再於 MCP 用戶端加入 markdown-vault-mcp serve 作為伺服器。
它能做什麼
- 搜尋、讀取與撰寫 Markdown 筆記已測試
怎麼使用
- 以
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve啟動伺服器。 - 從 MCP 用戶端以筆記的
path(例如notes/<note>.md)呼叫vault_read工具。
- 以
- 依關鍵字與語意搜尋筆記已測試
怎麼使用
- 以
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve啟動伺服器。 - 以
query呼叫vault_search工具,並將mode設為keyword。
- 以
- 追蹤反向連結、外部連結與失效連結已測試
怎麼使用
- 以
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve啟動伺服器。 - 以筆記的
path呼叫get_backlinks工具,查看哪些筆記連結至該筆記。
- 以
- 以 Git 提交、同步與檢視筆記歷史已測試
怎麼使用
- 將筆記資料夾設為至少有一次提交的 Git 儲存庫。
- 以
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve啟動伺服器。 - 以筆記的
path呼叫get_history工具檢視其歷史。
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 4 項可用
- 可離線使用
適合用來
- 搜尋 Markdown 筆記資料夾
- 讀取 Markdown 筆記
- 寫回 Markdown 筆記
- 追蹤筆記之間的反向連結與外部連結
- 以 git 歷史同步筆記
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月30日
- 版本 5.1.0
MCP 用戶端透過 stdio 連線,列出 44 個工具,呼叫 vault_read 也回傳了結果。