接入你的智能体
发布者自己的命令。不是 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