Obsidian Cdp MCP

黑曜石CDP MCP服务器

英语 | 中文

通过Chrome DevTools协议（CDP）连接到Obsidian，提供MCP工具接口。

特性

与REST API相比，CDP提供了更强大的功能：

先决条件

Obsidian必须在调试模式下启动:

# macOS
open -a Obsidian --args --remote-debugging-port=9222

# Or run directly
/Applications/Obsidian.app/Contents/MacOS/Obsidian --remote-debugging-port=9222

安装

使用npx（无需安装）

你可以使用 npx 无需安装即可直接运行服务器：

npx obsidian-cdp-mcp

全球安装

npm install -g obsidian-cdp-mcp

安装后，您可以使用 obsidian-cdp-mcp 直接命令。

来自源头

git clone https://github.com/QianChenglong/obsidian-cdp-mcp.git
cd obsidian-cdp-mcp
npm install
npm run build
npm link

MCP配置

代码伙伴

添加 ~/.codebuddy/settings.json:

{
  "mcpServers": {
    "obsidian-cdp": {
      "command": "npx",
      "args": ["obsidian-cdp-mcp"],
      "env": {
        "OBSIDIAN_DEBUG_PORT": "9222"
      }
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "obsidian-cdp": {
      "command": "obsidian-cdp-mcp",
      "env": {
        "OBSIDIAN_DEBUG_PORT": "9222"
      }
    }
  }
}

克劳德桌面版

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

{
  "mcpServers": {
    "obsidian-cdp": {
      "command": "npx",
      "args": ["obsidian-cdp-mcp"],
      "env": {
        "OBSIDIAN_DEBUG_PORT": "9222"
      }
    }
  }
}

可用工具

基本操作

文件和文件夹管理

链接和参考

元数据和属性

编辑操作

模板

插件和命令

调试功能（CDP专用）

用法示例

截图

{
  "name": "obsidian_screenshot",
  "arguments": { "format": "webp", "quality": 80 }
}

获取控制台日志

{
  "name": "obsidian_console",
  "arguments": { "limit": 20, "type": "error" }
}

执行JavaScript

{
  "name": "obsidian_eval",
  "arguments": {
    "code": "app.workspace.getActiveFile()?.path"
  }
}

搜索文件

{
  "name": "obsidian_search",
  "arguments": { "query": "mcp", "limit": 10 }
}

在特定文件夹中搜索文件

{
  "name": "obsidian_search",
  "arguments": { "query": "config", "path": "技术/kubernetes", "limit": 10 }
}

搜索文件夹

{
  "name": "obsidian_search_folders",
  "arguments": { "query": "work", "limit": 10 }
}

环境变量

故障排除

未找到黑曜石

确保Obsidian正在调试模式下运行：

curl http://localhost:9222/json

应返回包含黑曜石页面信息的JSON。

连接被拒绝

检查端口是否正确，或者黑曜石是否被防火墙阻止。

许可证

麻省理工学院