Obsidian Search MCP

Name: Obsidian Search MCP
Author: Atomzwieback

Atomzwieback

🔍 Search your Obsidian vault directly from Claude. Fast full-text search powered by Tantivy-Go, giving AI instant access to your entire knowledge base.

接入配置

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

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

claude mcp add obsidian-search --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env LOCAL_VAULT_PATH='<LOCAL_VAULT_PATH>' -- docker run -i --rm -e 'OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}' -v '{{config.LOCAL_VAULT_PATH}}:/vault:ro' -v obsidian-mcp-index:/data atomzwieback/obsidian-search-mcp:latest

~/.codex/config.toml

[mcp_servers.obsidian-search]
command = "docker"
args = ["run", "-i", "--rm", "-e", "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}", "-v", "{{config.LOCAL_VAULT_PATH}}:/vault:ro", "-v", "obsidian-mcp-index:/data", "atomzwieback/obsidian-search-mcp:latest"]
env = { OBSIDIAN_VAULT_PATH = "<OBSIDIAN_VAULT_PATH>", LOCAL_VAULT_PATH = "<LOCAL_VAULT_PATH>" }

# codex mcp add obsidian-search --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env LOCAL_VAULT_PATH='<LOCAL_VAULT_PATH>' -- docker run -i --rm -e 'OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}' -v '{{config.LOCAL_VAULT_PATH}}:/vault:ro' -v obsidian-mcp-index:/data atomzwieback/obsidian-search-mcp:latest

~/.cursor/mcp.json

{
  "mcpServers": {
    "obsidian-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}",
        "-v",
        "{{config.LOCAL_VAULT_PATH}}:/vault:ro",
        "-v",
        "obsidian-mcp-index:/data",
        "atomzwieback/obsidian-search-mcp:latest"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "LOCAL_VAULT_PATH": "<LOCAL_VAULT_PATH>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "obsidian-search": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}",
        "-v",
        "{{config.LOCAL_VAULT_PATH}}:/vault:ro",
        "-v",
        "obsidian-mcp-index:/data",
        "atomzwieback/obsidian-search-mcp:latest"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "LOCAL_VAULT_PATH": "<LOCAL_VAULT_PATH>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "obsidian-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}",
        "-v",
        "{{config.LOCAL_VAULT_PATH}}:/vault:ro",
        "-v",
        "obsidian-mcp-index:/data",
        "atomzwieback/obsidian-search-mcp:latest"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "LOCAL_VAULT_PATH": "<LOCAL_VAULT_PATH>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}",
        "-v",
        "{{config.LOCAL_VAULT_PATH}}:/vault:ro",
        "-v",
        "obsidian-mcp-index:/data",
        "atomzwieback/obsidian-search-mcp:latest"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "LOCAL_VAULT_PATH": "<LOCAL_VAULT_PATH>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "obsidian-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBSIDIAN_VAULT_PATH={{config.OBSIDIAN_VAULT_PATH}}",
        "-v",
        "{{config.LOCAL_VAULT_PATH}}:/vault:ro",
        "-v",
        "obsidian-mcp-index:/data",
        "atomzwieback/obsidian-search-mcp:latest"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "LOCAL_VAULT_PATH": "<LOCAL_VAULT_PATH>"
      }
    }
  }
}

需要的环境变量

OBSIDIAN_VAULT_PATH
LOCAL_VAULT_PATH

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

接入配置

需要的环境变量

相关推荐