Obsidian MCP Server

Name: Obsidian MCP Server
Author: cyanheads

cyanheads

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

Read, write, search and precisely edit Obsidian vault notes, tags and frontmatter over STDIO or Streamable HTTP.

接入配置

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

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

claude mcp add obsidian --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env CONFIG_PATH='<CONFIG_PATH>' --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env MAX_BODY_LENGTH='<MAX_BODY_LENGTH>' --env MAX_CONTENT_LENGTH='<MAX_CONTENT_LENGTH>' --env OBSIDIAN_HOST='<OBSIDIAN_HOST>' --env OBSIDIAN_PORT='<OBSIDIAN_PORT>' --env OBSIDIAN_PROTOCOL='<OBSIDIAN_PROTOCOL>' --env RATE_LIMIT_MAX_REQUESTS='<RATE_LIMIT_MAX_REQUESTS>' -- npx -y obsidian-mcp-server

~/.codex/config.toml

[mcp_servers.obsidian]
command = "npx"
args = ["-y", "obsidian-mcp-server"]
env = { OBSIDIAN_API_KEY = "<OBSIDIAN_API_KEY>", CONFIG_PATH = "<CONFIG_PATH>", MCP_TRANSPORT_TYPE = "<MCP_TRANSPORT_TYPE>", MCP_LOG_LEVEL = "<MCP_LOG_LEVEL>", MAX_BODY_LENGTH = "<MAX_BODY_LENGTH>", MAX_CONTENT_LENGTH = "<MAX_CONTENT_LENGTH>", OBSIDIAN_HOST = "<OBSIDIAN_HOST>", OBSIDIAN_PORT = "<OBSIDIAN_PORT>", OBSIDIAN_PROTOCOL = "<OBSIDIAN_PROTOCOL>", RATE_LIMIT_MAX_REQUESTS = "<RATE_LIMIT_MAX_REQUESTS>" }

# codex mcp add obsidian --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env CONFIG_PATH='<CONFIG_PATH>' --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env MAX_BODY_LENGTH='<MAX_BODY_LENGTH>' --env MAX_CONTENT_LENGTH='<MAX_CONTENT_LENGTH>' --env OBSIDIAN_HOST='<OBSIDIAN_HOST>' --env OBSIDIAN_PORT='<OBSIDIAN_PORT>' --env OBSIDIAN_PROTOCOL='<OBSIDIAN_PROTOCOL>' --env RATE_LIMIT_MAX_REQUESTS='<RATE_LIMIT_MAX_REQUESTS>' -- npx -y obsidian-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "CONFIG_PATH": "<CONFIG_PATH>",
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "MAX_BODY_LENGTH": "<MAX_BODY_LENGTH>",
        "MAX_CONTENT_LENGTH": "<MAX_CONTENT_LENGTH>",
        "OBSIDIAN_HOST": "<OBSIDIAN_HOST>",
        "OBSIDIAN_PORT": "<OBSIDIAN_PORT>",
        "OBSIDIAN_PROTOCOL": "<OBSIDIAN_PROTOCOL>",
        "RATE_LIMIT_MAX_REQUESTS": "<RATE_LIMIT_MAX_REQUESTS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "obsidian": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "CONFIG_PATH": "<CONFIG_PATH>",
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "MAX_BODY_LENGTH": "<MAX_BODY_LENGTH>",
        "MAX_CONTENT_LENGTH": "<MAX_CONTENT_LENGTH>",
        "OBSIDIAN_HOST": "<OBSIDIAN_HOST>",
        "OBSIDIAN_PORT": "<OBSIDIAN_PORT>",
        "OBSIDIAN_PROTOCOL": "<OBSIDIAN_PROTOCOL>",
        "RATE_LIMIT_MAX_REQUESTS": "<RATE_LIMIT_MAX_REQUESTS>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "CONFIG_PATH": "<CONFIG_PATH>",
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "MAX_BODY_LENGTH": "<MAX_BODY_LENGTH>",
        "MAX_CONTENT_LENGTH": "<MAX_CONTENT_LENGTH>",
        "OBSIDIAN_HOST": "<OBSIDIAN_HOST>",
        "OBSIDIAN_PORT": "<OBSIDIAN_PORT>",
        "OBSIDIAN_PROTOCOL": "<OBSIDIAN_PROTOCOL>",
        "RATE_LIMIT_MAX_REQUESTS": "<RATE_LIMIT_MAX_REQUESTS>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "CONFIG_PATH": "<CONFIG_PATH>",
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "MAX_BODY_LENGTH": "<MAX_BODY_LENGTH>",
        "MAX_CONTENT_LENGTH": "<MAX_CONTENT_LENGTH>",
        "OBSIDIAN_HOST": "<OBSIDIAN_HOST>",
        "OBSIDIAN_PORT": "<OBSIDIAN_PORT>",
        "OBSIDIAN_PROTOCOL": "<OBSIDIAN_PROTOCOL>",
        "RATE_LIMIT_MAX_REQUESTS": "<RATE_LIMIT_MAX_REQUESTS>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "CONFIG_PATH": "<CONFIG_PATH>",
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "MAX_BODY_LENGTH": "<MAX_BODY_LENGTH>",
        "MAX_CONTENT_LENGTH": "<MAX_CONTENT_LENGTH>",
        "OBSIDIAN_HOST": "<OBSIDIAN_HOST>",
        "OBSIDIAN_PORT": "<OBSIDIAN_PORT>",
        "OBSIDIAN_PROTOCOL": "<OBSIDIAN_PROTOCOL>",
        "RATE_LIMIT_MAX_REQUESTS": "<RATE_LIMIT_MAX_REQUESTS>"
      }
    }
  }
}

需要的环境变量

OBSIDIAN_API_KEY
CONFIG_PATH
MCP_TRANSPORT_TYPE
MCP_LOG_LEVEL
MAX_BODY_LENGTH
MAX_CONTENT_LENGTH
OBSIDIAN_HOST
OBSIDIAN_PORT
OBSIDIAN_PROTOCOL
RATE_LIMIT_MAX_REQUESTS

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

接入配置

需要的环境变量

相关推荐