Markdown Vault MCP

mcpkey · package

io.github.pvliesdonk/markdown-vault-mcp · v5.1.0

Generic markdown vault MCP with hybrid search

run it

on your own machines, one way per deploy method

generated from the record, not tested yet

#!/usr/bin/env bash
# markdown-vault (io.github.pvliesdonk/markdown-vault-mcp), recipe baremetal (generated).
# Generated by Hub for toolset "my-agent"; started by mcp-my-agent-markdown-vault.service.
set -euo pipefail
export HOST=127.0.0.1 PORT=8101
exec uvx mcp-proxy --host 127.0.0.1 --port 8101 --pass-environment -- uvx markdown-vault-mcp==5.1.0

[Unit]
Description=MCP server markdown-vault (toolset my-agent), generated by Hub
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=mcp
Group=mcp
EnvironmentFile=/etc/mcp/my-agent.env
Environment=HOME=/var/lib/mcp/markdown-vault
WorkingDirectory=/var/lib/mcp/markdown-vault
ExecStart=/opt/mcp/my-agent/bin/markdown-vault.sh
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/mcp/markdown-vault

[Install]
WantedBy=multi-user.target

generated from the record, not tested yet

docker run --rm -p 127.0.0.1:8101:8000 -e MARKDOWN_VAULT_MCP_KV_STORE_URL -e MARKDOWN_VAULT_MCP_TOOLS_ALLOW -e MARKDOWN_VAULT_MCP_TOOLS_DENY -e MARKDOWN_VAULT_MCP_SERVER_NAME -e MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION -e MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA -e MARKDOWN_VAULT_MCP_INSTRUCTIONS -e MARKDOWN_VAULT_MCP_LOG_LEVEL -e MARKDOWN_VAULT_MCP_LOG_FORMAT -e OLLAMA_HOST -e OPENAI_API_KEY -e VOYAGE_API_KEY -e OPENAI_BASE_URL -e OPENAI_EMBEDDING_MODEL -e MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S -e MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S -e MARKDOWN_VAULT_MCP_SOURCE_DIR -e MARKDOWN_VAULT_MCP_READ_ONLY -e MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING -e MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS -e MARKDOWN_VAULT_MCP_DISABLE_APPS_UI -e MARKDOWN_VAULT_MCP_INDEX_PATH -e MARKDOWN_VAULT_MCP_STATE_PATH -e MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH -e MARKDOWN_VAULT_MCP_INDEXED_FIELDS -e MARKDOWN_VAULT_MCP_REQUIRED_FIELDS -e MARKDOWN_VAULT_MCP_EXCLUDE -e MARKDOWN_VAULT_MCP_TITLE_FIELD -e MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS -e MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER -e MARKDOWN_VAULT_MCP_PROMPTS_FOLDER -e MARKDOWN_VAULT_MCP_CONVENTIONS_FILE -e MARKDOWN_VAULT_MCP_OKF_MODE -e MARKDOWN_VAULT_MCP_OKF_WRITE -e MARKDOWN_VAULT_MCP_OKF_VERIFY -e MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS -e MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB -e MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES -e MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE -e MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE -e MARKDOWN_VAULT_MCP_SNIPPET_WORDS -e MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA -e MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS -e MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS -e MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS -e MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS -e MARKDOWN_VAULT_MCP_FTS_WEIGHTS -e MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER -e MARKDOWN_VAULT_MCP_OLLAMA_MODEL -e MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY -e MARKDOWN_VAULT_MCP_VOYAGE_MODEL -e MARKDOWN_VAULT_MCP_OPENAI_BASE_URL -e MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL -e MARKDOWN_VAULT_MCP_FASTEMBED_MODEL -e MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR -e MARKDOWN_VAULT_MCP_EMBED_CONTEXT -e MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S -e MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE -e MARKDOWN_VAULT_MCP_GIT_TOKEN -e MARKDOWN_VAULT_MCP_GIT_REPO_URL -e MARKDOWN_VAULT_MCP_GIT_USERNAME -e MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S -e MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S -e MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME -e MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL -e MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM -e MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM -e MARKDOWN_VAULT_MCP_GIT_LFS -e MARKDOWN_VAULT_MCP_FILE_WATCHER -e MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S -e MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR -e MARKDOWN_VAULT_MCP_BOOT_REINDEX -e MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET -e MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN -e MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN -e MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS -e MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT -e MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S -e MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S -e MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S -e MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S -e MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES -e MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S -e MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S -e MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT ghcr.io/astral-sh/uv:python3.12-bookworm-slim sh -c 'uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx markdown-vault-mcp==5.1.0'

generated from the record, not tested yet

# Generated by Hub for toolset "my-agent" (2026-10-18T11:16:06+00:00).
# Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
#   cp .env.example .env    # fill the ${VAR}s
#   docker compose up -d && bash smoke.sh
# Remote servers are not here: clients reach them directly (see clients/).
name: mcp-my-agent
services:
  markdown-vault:
    image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
    command:
    - sh
    - -c
    - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx markdown-vault-mcp==5.1.0
    ports:
    - 127.0.0.1:8101:8000
    volumes:
    - uv-cache:/root/.cache/uv
    healthcheck:
      test:
      - CMD
      - python3
      - -c
      - import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/status')
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 2m
    restart: unless-stopped
    environment:
      MARKDOWN_VAULT_MCP_KV_STORE_URL: ${MARKDOWN_VAULT_MCP_KV_STORE_URL}
      MARKDOWN_VAULT_MCP_TOOLS_ALLOW: ${MARKDOWN_VAULT_MCP_TOOLS_ALLOW}
      MARKDOWN_VAULT_MCP_TOOLS_DENY: ${MARKDOWN_VAULT_MCP_TOOLS_DENY}
      MARKDOWN_VAULT_MCP_SERVER_NAME: ${MARKDOWN_VAULT_MCP_SERVER_NAME}
      MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION: ${MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION}
      MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA: ${MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA}
      MARKDOWN_VAULT_MCP_INSTRUCTIONS: ${MARKDOWN_VAULT_MCP_INSTRUCTIONS}
      MARKDOWN_VAULT_MCP_LOG_LEVEL: ${MARKDOWN_VAULT_MCP_LOG_LEVEL}
      MARKDOWN_VAULT_MCP_LOG_FORMAT: ${MARKDOWN_VAULT_MCP_LOG_FORMAT}
      OLLAMA_HOST: ${OLLAMA_HOST}
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      VOYAGE_API_KEY: ${VOYAGE_API_KEY}
      OPENAI_BASE_URL: ${OPENAI_BASE_URL}
      OPENAI_EMBEDDING_MODEL: ${OPENAI_EMBEDDING_MODEL}
      MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S: ${MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S}
      MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S: ${MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S}
      MARKDOWN_VAULT_MCP_SOURCE_DIR: ${MARKDOWN_VAULT_MCP_SOURCE_DIR}
      MARKDOWN_VAULT_MCP_READ_ONLY: ${MARKDOWN_VAULT_MCP_READ_ONLY}
      MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING: ${MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING}
      MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS: ${MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS}
      MARKDOWN_VAULT_MCP_DISABLE_APPS_UI: ${MARKDOWN_VAULT_MCP_DISABLE_APPS_UI}
      MARKDOWN_VAULT_MCP_INDEX_PATH: ${MARKDOWN_VAULT_MCP_INDEX_PATH}
      MARKDOWN_VAULT_MCP_STATE_PATH: ${MARKDOWN_VAULT_MCP_STATE_PATH}
      MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH: ${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH}
      MARKDOWN_VAULT_MCP_INDEXED_FIELDS: ${MARKDOWN_VAULT_MCP_INDEXED_FIELDS}
      MARKDOWN_VAULT_MCP_REQUIRED_FIELDS: ${MARKDOWN_VAULT_MCP_REQUIRED_FIELDS}
      MARKDOWN_VAULT_MCP_EXCLUDE: ${MARKDOWN_VAULT_MCP_EXCLUDE}
      MARKDOWN_VAULT_MCP_TITLE_FIELD: ${MARKDOWN_VAULT_MCP_TITLE_FIELD}
      MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS: ${MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS}
      MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER: ${MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER}
      MARKDOWN_VAULT_MCP_PROMPTS_FOLDER: ${MARKDOWN_VAULT_MCP_PROMPTS_FOLDER}
      MARKDOWN_VAULT_MCP_CONVENTIONS_FILE: ${MARKDOWN_VAULT_MCP_CONVENTIONS_FILE}
      MARKDOWN_VAULT_MCP_OKF_MODE: ${MARKDOWN_VAULT_MCP_OKF_MODE}
      MARKDOWN_VAULT_MCP_OKF_WRITE: ${MARKDOWN_VAULT_MCP_OKF_WRITE}
      MARKDOWN_VAULT_MCP_OKF_VERIFY: ${MARKDOWN_VAULT_MCP_OKF_VERIFY}
      MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS: ${MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS}
      MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB: ${MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB}
      MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES: ${MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES}
      MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE: ${MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE}
      MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE: ${MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE}
      MARKDOWN_VAULT_MCP_SNIPPET_WORDS: ${MARKDOWN_VAULT_MCP_SNIPPET_WORDS}
      MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA: ${MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA}
      MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS: ${MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS}
      MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS: ${MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS}
      MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS: ${MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS}
      MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS: ${MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS}
      MARKDOWN_VAULT_MCP_FTS_WEIGHTS: ${MARKDOWN_VAULT_MCP_FTS_WEIGHTS}
      MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER: ${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER}
      MARKDOWN_VAULT_MCP_OLLAMA_MODEL: ${MARKDOWN_VAULT_MCP_OLLAMA_MODEL}
      MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY: ${MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY}
      MARKDOWN_VAULT_MCP_VOYAGE_MODEL: ${MARKDOWN_VAULT_MCP_VOYAGE_MODEL}
      MARKDOWN_VAULT_MCP_OPENAI_BASE_URL: ${MARKDOWN_VAULT_MCP_OPENAI_BASE_URL}
      MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL: ${MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL}
      MARKDOWN_VAULT_MCP_FASTEMBED_MODEL: ${MARKDOWN_VAULT_MCP_FASTEMBED_MODEL}
      MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR: ${MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR}
      MARKDOWN_VAULT_MCP_EMBED_CONTEXT: ${MARKDOWN_VAULT_MCP_EMBED_CONTEXT}
      MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S: ${MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S}
      MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE: ${MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE}
      MARKDOWN_VAULT_MCP_GIT_TOKEN: ${MARKDOWN_VAULT_MCP_GIT_TOKEN}
      MARKDOWN_VAULT_MCP_GIT_REPO_URL: ${MARKDOWN_VAULT_MCP_GIT_REPO_URL}
      MARKDOWN_VAULT_MCP_GIT_USERNAME: ${MARKDOWN_VAULT_MCP_GIT_USERNAME}
      MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S: ${MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S}
      MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S: ${MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S}
      MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME: ${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME}
      MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL: ${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL}
      MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM: ${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM}
      MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM: ${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM}
      MARKDOWN_VAULT_MCP_GIT_LFS: ${MARKDOWN_VAULT_MCP_GIT_LFS}
      MARKDOWN_VAULT_MCP_FILE_WATCHER: ${MARKDOWN_VAULT_MCP_FILE_WATCHER}
      MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S: ${MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S}
      MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR: ${MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR}
      MARKDOWN_VAULT_MCP_BOOT_REINDEX: ${MARKDOWN_VAULT_MCP_BOOT_REINDEX}
      MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET: ${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}
      MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN: ${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}
      MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN: ${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}
      MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER: ${MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER}
      MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY: ${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}
      MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL: ${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL}
      MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL: ${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL}
      MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS: ${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS}
      MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES: ${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES}
      MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS: ${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS}
      MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT: ${MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT}
      MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S: ${MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S}
      MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S: ${MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S}
      MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S: ${MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S}
      MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S: ${MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S}
      MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES: ${MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES}
      MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S: ${MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S}
      MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S: ${MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S}
      MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT: ${MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT}
volumes:
  npm-cache: {}
  uv-cache: {}

generated from the record, not tested yet

# Generated by Hub for toolset "my-agent" (2026-10-18T11:16:06+00:00).
#   kubectl create namespace mcp
#   kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
#   kubectl apply -f kubernetes.yaml
# Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
# with auth in front before exposing any of them.
apiVersion: v1
kind: Namespace
metadata:
  name: mcp
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: markdown-vault
  namespace: mcp
  labels: &id001
    app: markdown-vault
spec:
  replicas: 1
  selector:
    matchLabels: *id001
  template:
    metadata:
      labels: *id001
    spec:
      containers:
      - name: markdown-vault
        image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
        ports:
        - containerPort: 8000
          name: http
        env:
        - name: MARKDOWN_VAULT_MCP_KV_STORE_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_KV_STORE_URL
        - name: MARKDOWN_VAULT_MCP_TOOLS_ALLOW
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TOOLS_ALLOW
        - name: MARKDOWN_VAULT_MCP_TOOLS_DENY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TOOLS_DENY
        - name: MARKDOWN_VAULT_MCP_SERVER_NAME
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SERVER_NAME
        - name: MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION
        - name: MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA
        - name: MARKDOWN_VAULT_MCP_INSTRUCTIONS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_INSTRUCTIONS
        - name: MARKDOWN_VAULT_MCP_LOG_LEVEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_LOG_LEVEL
        - name: MARKDOWN_VAULT_MCP_LOG_FORMAT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_LOG_FORMAT
        - name: OLLAMA_HOST
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: OLLAMA_HOST
        - name: OPENAI_API_KEY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: OPENAI_API_KEY
        - name: VOYAGE_API_KEY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: VOYAGE_API_KEY
        - name: OPENAI_BASE_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: OPENAI_BASE_URL
        - name: OPENAI_EMBEDDING_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: OPENAI_EMBEDDING_MODEL
        - name: MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S
        - name: MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S
        - name: MARKDOWN_VAULT_MCP_SOURCE_DIR
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SOURCE_DIR
        - name: MARKDOWN_VAULT_MCP_READ_ONLY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_READ_ONLY
        - name: MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING
        - name: MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS
        - name: MARKDOWN_VAULT_MCP_DISABLE_APPS_UI
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_DISABLE_APPS_UI
        - name: MARKDOWN_VAULT_MCP_INDEX_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_INDEX_PATH
        - name: MARKDOWN_VAULT_MCP_STATE_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_STATE_PATH
        - name: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
        - name: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
        - name: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
        - name: MARKDOWN_VAULT_MCP_EXCLUDE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EXCLUDE
        - name: MARKDOWN_VAULT_MCP_TITLE_FIELD
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TITLE_FIELD
        - name: MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS
        - name: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER
        - name: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
        - name: MARKDOWN_VAULT_MCP_CONVENTIONS_FILE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_CONVENTIONS_FILE
        - name: MARKDOWN_VAULT_MCP_OKF_MODE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OKF_MODE
        - name: MARKDOWN_VAULT_MCP_OKF_WRITE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OKF_WRITE
        - name: MARKDOWN_VAULT_MCP_OKF_VERIFY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OKF_VERIFY
        - name: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
        - name: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB
        - name: MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES
        - name: MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE
        - name: MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE
        - name: MARKDOWN_VAULT_MCP_SNIPPET_WORDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SNIPPET_WORDS
        - name: MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA
        - name: MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS
        - name: MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS
        - name: MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS
        - name: MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS
        - name: MARKDOWN_VAULT_MCP_FTS_WEIGHTS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FTS_WEIGHTS
        - name: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER
        - name: MARKDOWN_VAULT_MCP_OLLAMA_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OLLAMA_MODEL
        - name: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY
        - name: MARKDOWN_VAULT_MCP_VOYAGE_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_VOYAGE_MODEL
        - name: MARKDOWN_VAULT_MCP_OPENAI_BASE_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OPENAI_BASE_URL
        - name: MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL
        - name: MARKDOWN_VAULT_MCP_FASTEMBED_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FASTEMBED_MODEL
        - name: MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR
        - name: MARKDOWN_VAULT_MCP_EMBED_CONTEXT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EMBED_CONTEXT
        - name: MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S
        - name: MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE
        - name: MARKDOWN_VAULT_MCP_GIT_TOKEN
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_TOKEN
        - name: MARKDOWN_VAULT_MCP_GIT_REPO_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_REPO_URL
        - name: MARKDOWN_VAULT_MCP_GIT_USERNAME
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_USERNAME
        - name: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S
        - name: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S
        - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME
        - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL
        - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM
        - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM
        - name: MARKDOWN_VAULT_MCP_GIT_LFS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GIT_LFS
        - name: MARKDOWN_VAULT_MCP_FILE_WATCHER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FILE_WATCHER
        - name: MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S
        - name: MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR
        - name: MARKDOWN_VAULT_MCP_BOOT_REINDEX
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_BOOT_REINDEX
        - name: MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET
        - name: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN
        - name: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS
        - name: MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT
        - name: MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S
        - name: MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S
        - name: MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S
        - name: MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S
        - name: MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES
        - name: MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S
        - name: MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S
        - name: MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT
        command:
        - sh
        - -c
        - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx markdown-vault-mcp==5.1.0
        readinessProbe:
          httpGet:
            path: /status
            port: http
          initialDelaySeconds: 10
---
apiVersion: v1
kind: Service
metadata:
  name: markdown-vault
  namespace: mcp
spec:
  selector:
    app: markdown-vault
  ports:
  - port: 8000
    targetPort: http
    name: http

generated from the record, not tested yet

# Generated by Hub for toolset "my-agent" (2026-10-18T11:16:06+00:00).
# Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
# Each server under `servers` is one Deployment + Service; the keys after it configure
# upstream charts a worker verified.
servers:
  markdown-vault:
    enabled: true
    replicas: 1
    port: 8000
    path: /mcp
    container:
      name: markdown-vault
      image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
      ports:
      - containerPort: 8000
        name: http
      env:
      - name: MARKDOWN_VAULT_MCP_KV_STORE_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_KV_STORE_URL
      - name: MARKDOWN_VAULT_MCP_TOOLS_ALLOW
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TOOLS_ALLOW
      - name: MARKDOWN_VAULT_MCP_TOOLS_DENY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TOOLS_DENY
      - name: MARKDOWN_VAULT_MCP_SERVER_NAME
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SERVER_NAME
      - name: MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION
      - name: MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA
      - name: MARKDOWN_VAULT_MCP_INSTRUCTIONS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_INSTRUCTIONS
      - name: MARKDOWN_VAULT_MCP_LOG_LEVEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_LOG_LEVEL
      - name: MARKDOWN_VAULT_MCP_LOG_FORMAT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_LOG_FORMAT
      - name: OLLAMA_HOST
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: OLLAMA_HOST
      - name: OPENAI_API_KEY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: OPENAI_API_KEY
      - name: VOYAGE_API_KEY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: VOYAGE_API_KEY
      - name: OPENAI_BASE_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: OPENAI_BASE_URL
      - name: OPENAI_EMBEDDING_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: OPENAI_EMBEDDING_MODEL
      - name: MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S
      - name: MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S
      - name: MARKDOWN_VAULT_MCP_SOURCE_DIR
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SOURCE_DIR
      - name: MARKDOWN_VAULT_MCP_READ_ONLY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_READ_ONLY
      - name: MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING
      - name: MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS
      - name: MARKDOWN_VAULT_MCP_DISABLE_APPS_UI
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_DISABLE_APPS_UI
      - name: MARKDOWN_VAULT_MCP_INDEX_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_INDEX_PATH
      - name: MARKDOWN_VAULT_MCP_STATE_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_STATE_PATH
      - name: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
      - name: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
      - name: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
      - name: MARKDOWN_VAULT_MCP_EXCLUDE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EXCLUDE
      - name: MARKDOWN_VAULT_MCP_TITLE_FIELD
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TITLE_FIELD
      - name: MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS
      - name: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER
      - name: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
      - name: MARKDOWN_VAULT_MCP_CONVENTIONS_FILE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_CONVENTIONS_FILE
      - name: MARKDOWN_VAULT_MCP_OKF_MODE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OKF_MODE
      - name: MARKDOWN_VAULT_MCP_OKF_WRITE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OKF_WRITE
      - name: MARKDOWN_VAULT_MCP_OKF_VERIFY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OKF_VERIFY
      - name: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
      - name: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB
      - name: MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES
      - name: MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE
      - name: MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE
      - name: MARKDOWN_VAULT_MCP_SNIPPET_WORDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SNIPPET_WORDS
      - name: MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA
      - name: MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS
      - name: MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS
      - name: MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS
      - name: MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS
      - name: MARKDOWN_VAULT_MCP_FTS_WEIGHTS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FTS_WEIGHTS
      - name: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER
      - name: MARKDOWN_VAULT_MCP_OLLAMA_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OLLAMA_MODEL
      - name: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY
      - name: MARKDOWN_VAULT_MCP_VOYAGE_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_VOYAGE_MODEL
      - name: MARKDOWN_VAULT_MCP_OPENAI_BASE_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OPENAI_BASE_URL
      - name: MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL
      - name: MARKDOWN_VAULT_MCP_FASTEMBED_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FASTEMBED_MODEL
      - name: MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR
      - name: MARKDOWN_VAULT_MCP_EMBED_CONTEXT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EMBED_CONTEXT
      - name: MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S
      - name: MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE
      - name: MARKDOWN_VAULT_MCP_GIT_TOKEN
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_TOKEN
      - name: MARKDOWN_VAULT_MCP_GIT_REPO_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_REPO_URL
      - name: MARKDOWN_VAULT_MCP_GIT_USERNAME
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_USERNAME
      - name: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S
      - name: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S
      - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME
      - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL
      - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM
      - name: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM
      - name: MARKDOWN_VAULT_MCP_GIT_LFS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GIT_LFS
      - name: MARKDOWN_VAULT_MCP_FILE_WATCHER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FILE_WATCHER
      - name: MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S
      - name: MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR
      - name: MARKDOWN_VAULT_MCP_BOOT_REINDEX
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_BOOT_REINDEX
      - name: MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET
      - name: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN
      - name: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS
      - name: MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT
      - name: MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S
      - name: MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S
      - name: MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S
      - name: MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S
      - name: MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES
      - name: MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S
      - name: MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S
      - name: MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT
      command:
      - sh
      - -c
      - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx markdown-vault-mcp==5.1.0
      readinessProbe:
        httpGet:
          path: /status
          port: http
        initialDelaySeconds: 10

# helm install my-agent helm/my-agent -n mcp

in the cloud

one click: the provider's deploy form opens filled in, in your own account

koyeb

deploy to koyeb

The form opens with CHANGE_ME for each value you supply: 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_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_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_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. Fill them in before you deploy.

Clients connect to the service's https://…koyeb.app address plus /mcp.

azure

deploy to azure template

A Container Apps environment with one app per server, each with HTTPS ingress and one replica. The portal asks for each value you supply as a secure parameter; the deployment's outputs list the endpoints.

connect to it

copy what your client needs

uvx markdown-vault-mcp==5.1.0
# env: 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_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_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_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

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==5.1.0"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "${MARKDOWN_VAULT_MCP_KV_STORE_URL}",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "${MARKDOWN_VAULT_MCP_TOOLS_ALLOW}",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "${MARKDOWN_VAULT_MCP_TOOLS_DENY}",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "${MARKDOWN_VAULT_MCP_SERVER_NAME}",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "${MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS}",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "${MARKDOWN_VAULT_MCP_LOG_LEVEL}",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "${MARKDOWN_VAULT_MCP_LOG_FORMAT}",
        "OLLAMA_HOST": "${OLLAMA_HOST}",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "VOYAGE_API_KEY": "${VOYAGE_API_KEY}",
        "OPENAI_BASE_URL": "${OPENAI_BASE_URL}",
        "OPENAI_EMBEDDING_MODEL": "${OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "${MARKDOWN_VAULT_MCP_SOURCE_DIR}",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "${MARKDOWN_VAULT_MCP_READ_ONLY}",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "${MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING}",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "${MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS}",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "${MARKDOWN_VAULT_MCP_DISABLE_APPS_UI}",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "${MARKDOWN_VAULT_MCP_INDEX_PATH}",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "${MARKDOWN_VAULT_MCP_STATE_PATH}",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH}",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "${MARKDOWN_VAULT_MCP_INDEXED_FIELDS}",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "${MARKDOWN_VAULT_MCP_REQUIRED_FIELDS}",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "${MARKDOWN_VAULT_MCP_EXCLUDE}",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "${MARKDOWN_VAULT_MCP_TITLE_FIELD}",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "${MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS}",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "${MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER}",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "${MARKDOWN_VAULT_MCP_PROMPTS_FOLDER}",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "${MARKDOWN_VAULT_MCP_CONVENTIONS_FILE}",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "${MARKDOWN_VAULT_MCP_OKF_MODE}",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "${MARKDOWN_VAULT_MCP_OKF_WRITE}",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "${MARKDOWN_VAULT_MCP_OKF_VERIFY}",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "${MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS}",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "${MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB}",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "${MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES}",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "${MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE}",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "${MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE}",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "${MARKDOWN_VAULT_MCP_SNIPPET_WORDS}",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "${MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS}",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "${MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS}",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "${MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "${MARKDOWN_VAULT_MCP_FTS_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER}",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "${MARKDOWN_VAULT_MCP_OLLAMA_MODEL}",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "${MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY}",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "${MARKDOWN_VAULT_MCP_VOYAGE_MODEL}",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "${MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "${MARKDOWN_VAULT_MCP_FASTEMBED_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "${MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR}",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "${MARKDOWN_VAULT_MCP_EMBED_CONTEXT}",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "${MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE}",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "${MARKDOWN_VAULT_MCP_GIT_TOKEN}",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "${MARKDOWN_VAULT_MCP_GIT_REPO_URL}",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "${MARKDOWN_VAULT_MCP_GIT_USERNAME}",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "${MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S}",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "${MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "${MARKDOWN_VAULT_MCP_GIT_LFS}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "${MARKDOWN_VAULT_MCP_FILE_WATCHER}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR}",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "${MARKDOWN_VAULT_MCP_BOOT_REINDEX}",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "${MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "${MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "${MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "${MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "${MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES}",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "${MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S}",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "${MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S}",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "${MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT}"
      }
    }
  }
}

#!/usr/bin/env bash
# Registers every server with Claude Code (run once; `claude mcp list` to check).
set -euo pipefail
set -a; [ -f .env ] && source .env; set +a
claude mcp add markdown-vault -e "MARKDOWN_VAULT_MCP_KV_STORE_URL=${MARKDOWN_VAULT_MCP_KV_STORE_URL}" -e "MARKDOWN_VAULT_MCP_TOOLS_ALLOW=${MARKDOWN_VAULT_MCP_TOOLS_ALLOW}" -e "MARKDOWN_VAULT_MCP_TOOLS_DENY=${MARKDOWN_VAULT_MCP_TOOLS_DENY}" -e "MARKDOWN_VAULT_MCP_SERVER_NAME=${MARKDOWN_VAULT_MCP_SERVER_NAME}" -e "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION=${MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION}" -e "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA=${MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA}" -e "MARKDOWN_VAULT_MCP_INSTRUCTIONS=${MARKDOWN_VAULT_MCP_INSTRUCTIONS}" -e "MARKDOWN_VAULT_MCP_LOG_LEVEL=${MARKDOWN_VAULT_MCP_LOG_LEVEL}" -e "MARKDOWN_VAULT_MCP_LOG_FORMAT=${MARKDOWN_VAULT_MCP_LOG_FORMAT}" -e "OLLAMA_HOST=${OLLAMA_HOST}" -e "OPENAI_API_KEY=${OPENAI_API_KEY}" -e "VOYAGE_API_KEY=${VOYAGE_API_KEY}" -e "OPENAI_BASE_URL=${OPENAI_BASE_URL}" -e "OPENAI_EMBEDDING_MODEL=${OPENAI_EMBEDDING_MODEL}" -e "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=${MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S}" -e "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=${MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S}" -e "MARKDOWN_VAULT_MCP_SOURCE_DIR=${MARKDOWN_VAULT_MCP_SOURCE_DIR}" -e "MARKDOWN_VAULT_MCP_READ_ONLY=${MARKDOWN_VAULT_MCP_READ_ONLY}" -e "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=${MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING}" -e "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=${MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS}" -e "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=${MARKDOWN_VAULT_MCP_DISABLE_APPS_UI}" -e "MARKDOWN_VAULT_MCP_INDEX_PATH=${MARKDOWN_VAULT_MCP_INDEX_PATH}" -e "MARKDOWN_VAULT_MCP_STATE_PATH=${MARKDOWN_VAULT_MCP_STATE_PATH}" -e "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH=${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH}" -e "MARKDOWN_VAULT_MCP_INDEXED_FIELDS=${MARKDOWN_VAULT_MCP_INDEXED_FIELDS}" -e "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS=${MARKDOWN_VAULT_MCP_REQUIRED_FIELDS}" -e "MARKDOWN_VAULT_MCP_EXCLUDE=${MARKDOWN_VAULT_MCP_EXCLUDE}" -e "MARKDOWN_VAULT_MCP_TITLE_FIELD=${MARKDOWN_VAULT_MCP_TITLE_FIELD}" -e "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS=${MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS}" -e "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=${MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER}" -e "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER=${MARKDOWN_VAULT_MCP_PROMPTS_FOLDER}" -e "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=${MARKDOWN_VAULT_MCP_CONVENTIONS_FILE}" -e "MARKDOWN_VAULT_MCP_OKF_MODE=${MARKDOWN_VAULT_MCP_OKF_MODE}" -e "MARKDOWN_VAULT_MCP_OKF_WRITE=${MARKDOWN_VAULT_MCP_OKF_WRITE}" -e "MARKDOWN_VAULT_MCP_OKF_VERIFY=${MARKDOWN_VAULT_MCP_OKF_VERIFY}" -e "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS=${MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS}" -e "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=${MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB}" -e "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=${MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES}" -e "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=${MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE}" -e "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=${MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE}" -e "MARKDOWN_VAULT_MCP_SNIPPET_WORDS=${MARKDOWN_VAULT_MCP_SNIPPET_WORDS}" -e "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=${MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA}" -e "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=${MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS}" -e "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS=${MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS}" -e "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=${MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS}" -e "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS=${MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS}" -e "MARKDOWN_VAULT_MCP_FTS_WEIGHTS=${MARKDOWN_VAULT_MCP_FTS_WEIGHTS}" -e "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER}" -e "MARKDOWN_VAULT_MCP_OLLAMA_MODEL=${MARKDOWN_VAULT_MCP_OLLAMA_MODEL}" -e "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=${MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY}" -e "MARKDOWN_VAULT_MCP_VOYAGE_MODEL=${MARKDOWN_VAULT_MCP_VOYAGE_MODEL}" -e "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=${MARKDOWN_VAULT_MCP_OPENAI_BASE_URL}" -e "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=${MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL}" -e "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=${MARKDOWN_VAULT_MCP_FASTEMBED_MODEL}" -e "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR=${MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR}" -e "MARKDOWN_VAULT_MCP_EMBED_CONTEXT=${MARKDOWN_VAULT_MCP_EMBED_CONTEXT}" -e "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=${MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S}" -e "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=${MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE}" -e "MARKDOWN_VAULT_MCP_GIT_TOKEN=${MARKDOWN_VAULT_MCP_GIT_TOKEN}" -e "MARKDOWN_VAULT_MCP_GIT_REPO_URL=${MARKDOWN_VAULT_MCP_GIT_REPO_URL}" -e "MARKDOWN_VAULT_MCP_GIT_USERNAME=${MARKDOWN_VAULT_MCP_GIT_USERNAME}" -e "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=${MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S}" -e "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=${MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S}" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME}" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL}" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM=${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM}" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM=${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM}" -e "MARKDOWN_VAULT_MCP_GIT_LFS=${MARKDOWN_VAULT_MCP_GIT_LFS}" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER=${MARKDOWN_VAULT_MCP_FILE_WATCHER}" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=${MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S}" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=${MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR}" -e "MARKDOWN_VAULT_MCP_BOOT_REINDEX=${MARKDOWN_VAULT_MCP_BOOT_REINDEX}" -e "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET=${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}" -e "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN=${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}" -e "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN=${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER=${MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY=${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL=${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS}" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=${MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT}" -e "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=${MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S}" -e "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=${MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S}" -e "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=${MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S}" -e "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=${MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S}" -e "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=${MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES}" -e "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=${MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S}" -e "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=${MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S}" -e "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=${MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT}" -- uvx markdown-vault-mcp==5.1.0

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==5.1.0"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "${MARKDOWN_VAULT_MCP_KV_STORE_URL}",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "${MARKDOWN_VAULT_MCP_TOOLS_ALLOW}",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "${MARKDOWN_VAULT_MCP_TOOLS_DENY}",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "${MARKDOWN_VAULT_MCP_SERVER_NAME}",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "${MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS}",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "${MARKDOWN_VAULT_MCP_LOG_LEVEL}",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "${MARKDOWN_VAULT_MCP_LOG_FORMAT}",
        "OLLAMA_HOST": "${OLLAMA_HOST}",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "VOYAGE_API_KEY": "${VOYAGE_API_KEY}",
        "OPENAI_BASE_URL": "${OPENAI_BASE_URL}",
        "OPENAI_EMBEDDING_MODEL": "${OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "${MARKDOWN_VAULT_MCP_SOURCE_DIR}",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "${MARKDOWN_VAULT_MCP_READ_ONLY}",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "${MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING}",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "${MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS}",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "${MARKDOWN_VAULT_MCP_DISABLE_APPS_UI}",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "${MARKDOWN_VAULT_MCP_INDEX_PATH}",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "${MARKDOWN_VAULT_MCP_STATE_PATH}",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH}",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "${MARKDOWN_VAULT_MCP_INDEXED_FIELDS}",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "${MARKDOWN_VAULT_MCP_REQUIRED_FIELDS}",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "${MARKDOWN_VAULT_MCP_EXCLUDE}",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "${MARKDOWN_VAULT_MCP_TITLE_FIELD}",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "${MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS}",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "${MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER}",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "${MARKDOWN_VAULT_MCP_PROMPTS_FOLDER}",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "${MARKDOWN_VAULT_MCP_CONVENTIONS_FILE}",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "${MARKDOWN_VAULT_MCP_OKF_MODE}",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "${MARKDOWN_VAULT_MCP_OKF_WRITE}",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "${MARKDOWN_VAULT_MCP_OKF_VERIFY}",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "${MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS}",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "${MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB}",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "${MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES}",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "${MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE}",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "${MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE}",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "${MARKDOWN_VAULT_MCP_SNIPPET_WORDS}",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "${MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS}",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "${MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS}",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "${MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "${MARKDOWN_VAULT_MCP_FTS_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER}",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "${MARKDOWN_VAULT_MCP_OLLAMA_MODEL}",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "${MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY}",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "${MARKDOWN_VAULT_MCP_VOYAGE_MODEL}",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "${MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "${MARKDOWN_VAULT_MCP_FASTEMBED_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "${MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR}",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "${MARKDOWN_VAULT_MCP_EMBED_CONTEXT}",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "${MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE}",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "${MARKDOWN_VAULT_MCP_GIT_TOKEN}",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "${MARKDOWN_VAULT_MCP_GIT_REPO_URL}",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "${MARKDOWN_VAULT_MCP_GIT_USERNAME}",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "${MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S}",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "${MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "${MARKDOWN_VAULT_MCP_GIT_LFS}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "${MARKDOWN_VAULT_MCP_FILE_WATCHER}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR}",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "${MARKDOWN_VAULT_MCP_BOOT_REINDEX}",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "${MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "${MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "${MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "${MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "${MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES}",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "${MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S}",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "${MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S}",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "${MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT}"
      }
    }
  }
}

{
  "servers": {
    "markdown-vault": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==5.1.0"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "${MARKDOWN_VAULT_MCP_KV_STORE_URL}",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "${MARKDOWN_VAULT_MCP_TOOLS_ALLOW}",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "${MARKDOWN_VAULT_MCP_TOOLS_DENY}",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "${MARKDOWN_VAULT_MCP_SERVER_NAME}",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "${MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA}",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "${MARKDOWN_VAULT_MCP_INSTRUCTIONS}",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "${MARKDOWN_VAULT_MCP_LOG_LEVEL}",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "${MARKDOWN_VAULT_MCP_LOG_FORMAT}",
        "OLLAMA_HOST": "${OLLAMA_HOST}",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "VOYAGE_API_KEY": "${VOYAGE_API_KEY}",
        "OPENAI_BASE_URL": "${OPENAI_BASE_URL}",
        "OPENAI_EMBEDDING_MODEL": "${OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "${MARKDOWN_VAULT_MCP_SOURCE_DIR}",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "${MARKDOWN_VAULT_MCP_READ_ONLY}",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "${MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING}",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "${MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS}",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "${MARKDOWN_VAULT_MCP_DISABLE_APPS_UI}",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "${MARKDOWN_VAULT_MCP_INDEX_PATH}",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "${MARKDOWN_VAULT_MCP_STATE_PATH}",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH}",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "${MARKDOWN_VAULT_MCP_INDEXED_FIELDS}",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "${MARKDOWN_VAULT_MCP_REQUIRED_FIELDS}",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "${MARKDOWN_VAULT_MCP_EXCLUDE}",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "${MARKDOWN_VAULT_MCP_TITLE_FIELD}",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "${MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS}",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "${MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER}",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "${MARKDOWN_VAULT_MCP_PROMPTS_FOLDER}",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "${MARKDOWN_VAULT_MCP_CONVENTIONS_FILE}",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "${MARKDOWN_VAULT_MCP_OKF_MODE}",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "${MARKDOWN_VAULT_MCP_OKF_WRITE}",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "${MARKDOWN_VAULT_MCP_OKF_VERIFY}",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "${MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS}",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "${MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB}",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "${MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES}",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "${MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE}",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "${MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE}",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "${MARKDOWN_VAULT_MCP_SNIPPET_WORDS}",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "${MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS}",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "${MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS}",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "${MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS}",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "${MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "${MARKDOWN_VAULT_MCP_FTS_WEIGHTS}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER}",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "${MARKDOWN_VAULT_MCP_OLLAMA_MODEL}",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "${MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY}",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "${MARKDOWN_VAULT_MCP_VOYAGE_MODEL}",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "${MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "${MARKDOWN_VAULT_MCP_FASTEMBED_MODEL}",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "${MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR}",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "${MARKDOWN_VAULT_MCP_EMBED_CONTEXT}",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "${MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S}",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "${MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE}",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "${MARKDOWN_VAULT_MCP_GIT_TOKEN}",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "${MARKDOWN_VAULT_MCP_GIT_REPO_URL}",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "${MARKDOWN_VAULT_MCP_GIT_USERNAME}",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "${MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S}",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "${MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "${MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM}",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "${MARKDOWN_VAULT_MCP_GIT_LFS}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "${MARKDOWN_VAULT_MCP_FILE_WATCHER}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S}",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "${MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR}",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "${MARKDOWN_VAULT_MCP_BOOT_REINDEX}",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "${MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "${MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "${MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "${MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "${MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "${MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S}",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "${MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES}",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "${MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S}",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "${MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S}",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "${MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT}"
      }
    }
  }
}

name: my-agent
target: local
servers:
- hub: io.github.pvliesdonk/markdown-vault-mcp

not probed yet: tools unpinned, ingest lists them

tools

Not probed yetThe tools appear once the hub or its worker has listed this entry. Running it still works: your client lists them on first start.

how to reach it

package: pypi [email protected]
needs env: 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_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_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_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
package: oci ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0
needs env: 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_KV_STORE_URL, MARKDOWN_VAULT_MCP_APP_DOMAIN, MARKDOWN_VAULT_MCP_TOOLS_ALLOW, MARKDOWN_VAULT_MCP_TOOLS_DENY, MARKDOWN_VAULT_MCP_AUTH_MODE, MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE, MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT, MARKDOWN_VAULT_MCP_SERVER_NAME, MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION, MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA, MARKDOWN_VAULT_MCP_INSTRUCTIONS, MARKDOWN_VAULT_MCP_HTTP_PATH, MARKDOWN_VAULT_MCP_HEALTH_DETAIL, PUID, PGID, 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_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_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_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

about

kind: mcp from registry
source: github.com/pvliesdonk/markdown-vault-mcp
website: pvliesdonk.github.io/markdown-vault-mcp/
version: 5.1.0
updated: 2026-10-07
status: active
probe: unprobed
registry: io.github.pvliesdonk/markdown-vault-mcp
owner: request removal

repository

score 70 of 100

stars: 34 13 forks
last commit: 2026-10-17 390 in 90 days
license: MIT
release: 2026-10-07
issues: 140 open · 726 closed
account: pvliesdonk user
score: activity 30 of 30
maintenance 25 of 25
ownership 0 of 10
popularity 15 of 35
read: 2026-10-17 from GitHub