Markdown Vault MCP

Name: Markdown Vault MCP
Author: pvliesdonk

pvliesdonk

开始使用源码仓库官网与文档

Generic markdown vault MCP with hybrid search

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add markdown-vault --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env VOYAGE_API_KEY='<VOYAGE_API_KEY>' --env MARKDOWN_VAULT_MCP_GIT_TOKEN='<MARKDOWN_VAULT_MCP_GIT_TOKEN>' --env MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET='<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN='<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN='<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY='<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>' -- uvx markdown-vault-mcp

~/.codex/config.toml

[mcp_servers.markdown-vault]
command = "uvx"
args = ["markdown-vault-mcp"]
env = { OPENAI_API_KEY = "<OPENAI_API_KEY>", VOYAGE_API_KEY = "<VOYAGE_API_KEY>", MARKDOWN_VAULT_MCP_GIT_TOKEN = "<MARKDOWN_VAULT_MCP_GIT_TOKEN>", 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_OPENAI_API_KEY = "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>" }

# codex mcp add markdown-vault --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env VOYAGE_API_KEY='<VOYAGE_API_KEY>' --env MARKDOWN_VAULT_MCP_GIT_TOKEN='<MARKDOWN_VAULT_MCP_GIT_TOKEN>' --env MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET='<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN='<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN='<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY='<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>' -- uvx markdown-vault-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "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_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "markdown-vault": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "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_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "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_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "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_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "markdown-vault": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "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_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
      }
    }
  }
}

需要的环境变量

OPENAI_API_KEY
VOYAGE_API_KEY
MARKDOWN_VAULT_MCP_GIT_TOKEN
MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐