MCP Obsidian CLI

mcp黑曜石cli

商标声明： “Obsidian”是Obsidian Publishing，股份有限公司的商标。本项目不隶属于或认可Obsidian出版社。

MCP服务器，包装了Obsidian CLI，使AI助手能够通过模型上下文协议完全访问Obsidian的原生API-搜索索引、wikilink解析、任务、属性、每日笔记、反向链接和80+命令。

为什么存在

每个现有的Obsidian MCP服务器都采用两种方法之一：本地REST API插件（需要API密钥、HTTP开销、有限的命令面）或原始文件系统访问（无Obsidian感知-无搜索索引、无wikilink解析、无任务查询）。两者都没有抓住重点。

mcp-obsidian-cli 封装了Obsidian CLI插件，该插件通过IPC直接与正在运行的Obsidian实例通信。这意味着可以完全访问Obsidian的内部API，无需任何配置-无API密钥，无REST插件，无令牌管理。

快速开始

npx mcp-obsidian-cli

Claude桌面配置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian-cli"],
      "env": {
        "OBSIDIAN_VAULT": "my-vault"
      }
    }
  }
}

需求

• 在CLI插件处于活动状态时运行黑曜石
• obsidian 在你的路上
• Node.js>=18

运作原理

服务器将Obsidian CLI命令作为MCP工具公开。通用直通工具处理整个CLI界面（80多个命令），以及用于常见操作的键入便利工具：

通用的 obsidian 工具意味着MCP服务器永远不会落后于CLI——新的CLI命令无需服务器更新即可立即工作。

环境变量

配置文件

服务器可以从YAML配置文件中读取设置：

• 违约： ~/.config/mcp-obsidian-cli/config.yaml
• 随着 XDG_CONFIG_HOME: $XDG_CONFIG_HOME/mcp-obsidian-cli/config.yaml

配置文件格式：

vault: "my-vault"
cliPath: "obsidian"
timeoutMs: 15000

配置优先级：环境变量>配置文件>硬编码默认值

与替代品相比

许可证

麻省理工学院


维护 @斯通马特 根据MIT许可证获得许可