接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
uvx markdown-vault-mcp==6.1.2Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
MARKDOWN_VAULT_MCP_KV_STORE_URL=<value> MARKDOWN_VAULT_MCP_TOOLS_ALLOW=<value> MARKDOWN_VAULT_MCP_TOOLS_DENY=<value> MARKDOWN_VAULT_MCP_SERVER_NAME=<value> MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION=<value> MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA=<value> MARKDOWN_VAULT_MCP_INSTRUCTIONS=<value> MARKDOWN_VAULT_MCP_LOG_LEVEL=<value> MARKDOWN_VAULT_MCP_LOG_FORMAT=<value> OLLAMA_HOST=<value> OPENAI_API_KEY=<secret> VOYAGE_API_KEY=<secret> OPENAI_BASE_URL=<value> OPENAI_EMBEDDING_MODEL=<value> MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=<value> MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=<value> MARKDOWN_VAULT_MCP_SERVER_URL=<value> MARKDOWN_VAULT_MCP_CLIENT_CONFIG=<value> MARKDOWN_VAULT_MCP_CLIENT_TOKEN=<secret> MARKDOWN_VAULT_MCP_SOURCE_DIR=<value> MARKDOWN_VAULT_MCP_READ_ONLY=<value> MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=<value> MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=<value> MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=<value> MARKDOWN_VAULT_MCP_INDEX_PATH=<value> MARKDOWN_VAULT_MCP_STATE_PATH=<value> MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH=<value> MARKDOWN_VAULT_MCP_EMBEDDING_STORE=<value> MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH=<value> MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB=<value> MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN=<secret> MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA=<value> MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE=<value> MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S=<value> MARKDOWN_VAULT_MCP_INDEXED_FIELDS=<value> MARKDOWN_VAULT_MCP_REQUIRED_FIELDS=<value> MARKDOWN_VAULT_MCP_EXCLUDE=<value> MARKDOWN_VAULT_MCP_TITLE_FIELD=<value> MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS=<value> MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=<value> MARKDOWN_VAULT_MCP_PROMPTS_FOLDER=<value> MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=<value> MARKDOWN_VAULT_MCP_OKF_MODE=<value> MARKDOWN_VAULT_MCP_OKF_WRITE=<value> MARKDOWN_VAULT_MCP_OKF_VERIFY=<value> MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS=<value> MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS=<value> MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=<value> MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=<value> MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=<value> MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=<value> MARKDOWN_VAULT_MCP_SNIPPET_WORDS=<value> MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=<value> MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=<value> MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS=<value> MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=<value> MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS=<value> MARKDOWN_VAULT_MCP_FTS_WEIGHTS=<value> MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=<value> MARKDOWN_VAULT_MCP_OLLAMA_MODEL=<value> MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=<value> MARKDOWN_VAULT_MCP_VOYAGE_MODEL=<value> MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=<value> MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=<value> MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=<value> MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR=<value> MARKDOWN_VAULT_MCP_EMBED_CONTEXT=<value> MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=<value> MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=<value> MARKDOWN_VAULT_MCP_GIT_TOKEN=<secret> MARKDOWN_VAULT_MCP_GIT_REPO_URL=<value> MARKDOWN_VAULT_MCP_GIT_USERNAME=<value> MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=<value> MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=<value> MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=<value> MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=<value> MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM=<value> MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM=<value> MARKDOWN_VAULT_MCP_GIT_LFS=<value> MARKDOWN_VAULT_MCP_FILE_WATCHER=<value> MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=<value> MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=<value> MARKDOWN_VAULT_MCP_BOOT_REINDEX=<value> MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET=<secret> MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN=<secret> MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN=<secret> MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY=<secret> MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=<value> MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=<value> MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=<value> MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=<value> MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=<value> MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=<value> MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=<value> MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=<value> MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=<value> MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=<value> claude mcp add pvliesdonk-markdown-vault-mcp -- uvx markdown-vault-mcp==6.1.2在終端機中執行。
{ "mcpServers": { "pvliesdonk-markdown-vault-mcp": { "command": "uvx", "args": [ "markdown-vault-mcp==6.1.2" ], "env": { "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<value>", "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<value>", "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<value>", "MARKDOWN_VAULT_MCP_SERVER_NAME": "<value>", "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<value>", "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<value>", "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<value>", "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<value>", "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<value>", "OLLAMA_HOST": "<value>", "OPENAI_API_KEY": "<secret>", "VOYAGE_API_KEY": "<secret>", "OPENAI_BASE_URL": "<value>", "OPENAI_EMBEDDING_MODEL": "<value>", "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_SERVER_URL": "<value>", "MARKDOWN_VAULT_MCP_CLIENT_CONFIG": "<value>", "MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<value>", "MARKDOWN_VAULT_MCP_READ_ONLY": "<value>", "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<value>", "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<value>", "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<value>", "MARKDOWN_VAULT_MCP_INDEX_PATH": "<value>", "MARKDOWN_VAULT_MCP_STATE_PATH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<secret>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_EXCLUDE": "<value>", "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<value>", "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<value>", "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<value>", "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<value>", "MARKDOWN_VAULT_MCP_OKF_MODE": "<value>", "MARKDOWN_VAULT_MCP_OKF_WRITE": "<value>", "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<value>", "MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS": "<value>", "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<value>", "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<value>", "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<value>", "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<value>", "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<value>", "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<value>", "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<value>", "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<value>", "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<value>", "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<value>", "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<value>", "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<value>", "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<value>", "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<value>", "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<value>", "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<value>", "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<value>", "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<value>", "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<value>", "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<value>", "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<value>", "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<value>", "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<value>", "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<value>", "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<value>", "MARKDOWN_VAULT_MCP_GIT_LFS": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<value>", "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<value>", "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<secret>", "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<secret>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<value>", "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<value>", "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<value>", "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
Generic markdown vault MCP with hybrid search
Documentation | Config wizard | PyPI | Docker
Give Claude, or any MCP client, a folder of Markdown notes to search, read and write. An Obsidian vault works as it is.
read fetches the whole section. See Embeddings.write, edit, append, delete, rename, move_folder, fetch, git_sync, the okf_* tools, create_upload_link) are on by default and hidden when MARKDOWN_VAULT_MCP_READ_ONLY=true. Replacing a file takes the etag from reading it, and per-folder _conventions.md rules reach the client as it writes.MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=true, write, edit and append name each link they added that doesn't resolve.The tools reference lists every tool. The same engine is a Python library: see the Vault API.
What the server can reach, what it changes and who gets in is set out in the security model; the block below says who it serves and where it stops.
It suits one person or a small team who keep notes as Markdown files and want Claude to search them, follow their links and write back into them, on their own machine or as a shared server. It reaches the vault folder, plus only what you configure: a git remote, an embedding or summarizing model, and the URLs a fetch call names.
What it assumes:
MARKDOWN_VAULT_MCP_SERVER_NAME.MARKDOWN_VAULT_MCP_INDEX_PATH, the index and that file stay in memory and are rebuilt at each start.Reach for something else for a corpus of hundreds of thousands of chunks (a vector database behind a retrieval pipeline), for mostly scanned or office documents (a document management system with text recognition), or for many users who must not see each other's notes (a multi-tenant knowledge platform): every caller the server admits gets every tool it exposes.
Pick the client you use. Each line installs the released version; the Get started tutorials carry on from there.
Claude Desktop. Download the .mcpb bundle from the releases page and open it with Claude Desktop (or Settings › Extensions › Advanced settings › Install Extension…). Claude Desktop asks for the required settings itself. Tutorial.
Claude Code. Two commands inside Claude Code; the second asks for a scope. Tutorial.
/plugin marketplace add pvliesdonk/claude-plugins
/plugin install markdown-vault-mcp@pvliesdonk
A client that runs a command (stdio). To register it in Claude Code, see the Claude Code tutorial.
uv tool install "markdown-vault-mcp"
markdown-vault-mcp serve
A server for remote clients (streamable HTTP). A remote server connects the clients.
docker run --rm -p 8000:8000 --env-file .env ghcr.io/pvliesdonk/markdown-vault-mcp:latest
A compose.yml ships at the repository root and runs as-is: copy .env.example to .env, then docker compose up -d. Deploy covers authentication, OIDC, a reverse proxy and system packages (.deb/.rpm on the releases page). The server answers /health and /health/ready outside the MCP mount, and its get_server_info tool reports the running version.
The plain package covers keyword search, the write tools and git. Search by meaning, the file watcher, the summarize tool and keeping embeddings in PostgreSQL need extras; [all] installs every one:
uv tool install "markdown-vault-mcp[all]"
The Docker image, the .mcpb bundle and the Claude Code plugin already include them. Installation lists each extra.
Everything is configured through environment variables with the MARKDOWN_VAULT_MCP_ prefix. The ones most installs set:
Every variable the server reads, the shared ones included, is in the configuration reference; .env.example lists the same surface in copy-paste form, and the config wizard writes one for your deployment.
CONTRIBUTING.md and SECURITY.md at the root..md extension; frontmatter is optional by default (REQUIRED_FIELDS opts into enforcement).asyncio.to_thread(). File writes return after saving, while index updates run in the background. Index-dependent mutations wait for prior writes; see index freshness.INDEX_SEMANTICS_VERSION so deployed vaults rebuild themselves once on upgrade.The full decision log lives in the design document.
Generic markdown vault MCP with hybrid search
{ "mcpServers": { "pvliesdonk-markdown-vault-mcp": { "command": "uvx", "args": [ "markdown-vault-mcp==6.1.2" ], "env": { "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<value>", "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<value>", "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<value>", "MARKDOWN_VAULT_MCP_SERVER_NAME": "<value>", "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<value>", "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<value>", "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<value>", "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<value>", "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<value>", "OLLAMA_HOST": "<value>", "OPENAI_API_KEY": "<secret>", "VOYAGE_API_KEY": "<secret>", "OPENAI_BASE_URL": "<value>", "OPENAI_EMBEDDING_MODEL": "<value>", "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_SERVER_URL": "<value>", "MARKDOWN_VAULT_MCP_CLIENT_CONFIG": "<value>", "MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<value>", "MARKDOWN_VAULT_MCP_READ_ONLY": "<value>", "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<value>", "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<value>", "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<value>", "MARKDOWN_VAULT_MCP_INDEX_PATH": "<value>", "MARKDOWN_VAULT_MCP_STATE_PATH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<secret>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_EXCLUDE": "<value>", "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<value>", "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<value>", "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<value>", "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<value>", "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<value>", "MARKDOWN_VAULT_MCP_OKF_MODE": "<value>", "MARKDOWN_VAULT_MCP_OKF_WRITE": "<value>", "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<value>", "MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS": "<value>", "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<value>", "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<value>", "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<value>", "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<value>", "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<value>", "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<value>", "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<value>", "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<value>", "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<value>", "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<value>", "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<value>", "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<value>", "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<value>", "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<value>", "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<value>", "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<value>", "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<value>", "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<value>", "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<value>", "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<value>", "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<value>", "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<value>", "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<value>", "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<value>", "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<value>", "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<value>", "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<value>", "MARKDOWN_VAULT_MCP_GIT_LFS": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<value>", "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<value>", "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<value>", "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<secret>", "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<secret>", "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<secret>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<value>", "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<value>", "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<value>", "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<value>", "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<value>", "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:MARKDOWN_VAULT_MCP_KV_STORE_URL, MARKDOWN_VAULT_MCP_TOOLS_ALLOW, MARKDOWN_VAULT_MCP_TOOLS_DENY, MARKDOWN_VAULT_MCP_SERVER_NAME, MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION, MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA, MARKDOWN_VAULT_MCP_INSTRUCTIONS, MARKDOWN_VAULT_MCP_LOG_LEVEL, MARKDOWN_VAULT_MCP_LOG_FORMAT, OLLAMA_HOST, OPENAI_API_KEY, VOYAGE_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S, MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S, MARKDOWN_VAULT_MCP_SERVER_URL, MARKDOWN_VAULT_MCP_CLIENT_CONFIG, MARKDOWN_VAULT_MCP_CLIENT_TOKEN, MARKDOWN_VAULT_MCP_SOURCE_DIR, MARKDOWN_VAULT_MCP_READ_ONLY, MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING, MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS, MARKDOWN_VAULT_MCP_DISABLE_APPS_UI, MARKDOWN_VAULT_MCP_INDEX_PATH, MARKDOWN_VAULT_MCP_STATE_PATH, MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH, MARKDOWN_VAULT_MCP_EMBEDDING_STORE, MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH, MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S, MARKDOWN_VAULT_MCP_INDEXED_FIELDS, MARKDOWN_VAULT_MCP_REQUIRED_FIELDS, MARKDOWN_VAULT_MCP_EXCLUDE, MARKDOWN_VAULT_MCP_TITLE_FIELD, MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS, MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER, MARKDOWN_VAULT_MCP_PROMPTS_FOLDER, MARKDOWN_VAULT_MCP_CONVENTIONS_FILE, MARKDOWN_VAULT_MCP_OKF_MODE, MARKDOWN_VAULT_MCP_OKF_WRITE, MARKDOWN_VAULT_MCP_OKF_VERIFY, MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS, MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS, MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB, MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES, MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE, MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE, MARKDOWN_VAULT_MCP_SNIPPET_WORDS, MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA, MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS, MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS, MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS, MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS, MARKDOWN_VAULT_MCP_FTS_WEIGHTS, MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER, MARKDOWN_VAULT_MCP_OLLAMA_MODEL, MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY, MARKDOWN_VAULT_MCP_VOYAGE_MODEL, MARKDOWN_VAULT_MCP_OPENAI_BASE_URL, MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL, MARKDOWN_VAULT_MCP_FASTEMBED_MODEL, MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR, MARKDOWN_VAULT_MCP_EMBED_CONTEXT, MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S, MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE, MARKDOWN_VAULT_MCP_GIT_TOKEN, MARKDOWN_VAULT_MCP_GIT_REPO_URL, MARKDOWN_VAULT_MCP_GIT_USERNAME, MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S, MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S, MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME, MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL, MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM, MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM, MARKDOWN_VAULT_MCP_GIT_LFS, MARKDOWN_VAULT_MCP_FILE_WATCHER, MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S, MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR, MARKDOWN_VAULT_MCP_BOOT_REINDEX, MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN, MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS, MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT, MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S, MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S, MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S, MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S, MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES, MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S, MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S, MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT, MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S, MARKDOWN_VAULT_MCP_BASE_URL, MARKDOWN_VAULT_MCP_BEARER_TOKEN, MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL, MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID, MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET, MARKDOWN_VAULT_MCP_OIDC_AUDIENCE, MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES, MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES, MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY, MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN, MARKDOWN_VAULT_MCP_APP_DOMAIN, MARKDOWN_VAULT_MCP_AUTH_MODE, MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE, MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT, MARKDOWN_VAULT_MCP_HTTP_PATH, MARKDOWN_VAULT_MCP_HEALTH_DETAIL, PUID, PGID。
Markdown Vault 透過 stdio 在本機執行。
上次檢查時間:2026-11-17。 Generic markdown vault MCP with hybrid search