Advanced MCP server for interacting with Obsidian via the Local REST API community plugin. It empowers AI agents (like Claude) to deeply understand your vault's structure, links, and content—beyond basic read/write operations.
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add advanced-server-to-interact-with-obsidia --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx mcp-obsidian-advanced~/.codex/config.toml
[mcp_servers.advanced-server-to-interact-with-obsidia]
command = "uvx"
args = ["mcp-obsidian-advanced"]
env = { OBSIDIAN_API_KEY = "<OBSIDIAN_API_KEY>", OBSIDIAN_VAULT_PATH = "<OBSIDIAN_VAULT_PATH>" }
# codex mcp add advanced-server-to-interact-with-obsidia --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx mcp-obsidian-advanced~/.cursor/mcp.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"advanced-server-to-interact-with-obsidia": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}需要的环境变量
OBSIDIAN_API_KEYOBSIDIAN_VAULT_PATH
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。