项目简介

Obsidian CDP MCP 服务器是一个专门为 Obsidian 笔记软件设计的 MCP 服务,通过 Chrome DevTools 协议实现对 Obsidian 的深度控制,相比传统 REST API 提供了更多高级功能。

主要功能

  • 文件管理:读取、写入、搜索和打开笔记文件
  • 界面操作:实时截图、获取控制台输出、查询 DOM 元素
  • 插件系统:列出和管理所有插件,执行任意命令
  • 高级调试:执行 JavaScript 代码,访问完整的 Obsidian API
  • 实时监控:捕获 Obsidian 的控制台日志和错误信息

安装步骤

  1. 确保 Obsidian 处于调试模式

    • macOS:'open -a Obsidian --args --remote-debugging-port=9222'
    • 其他系统:启动 Obsidian 时添加 '--remote-debugging-port=9222' 参数
  2. 安装服务器

    • 使用 npx(无需安装):'npx obsidian-cdp-mcp'
    • 或全局安装:'npm install -g obsidian-cdp-mcp'

服务器配置

在 MCP 客户端配置文件中添加以下内容:

{
  "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"
    }
  }
}

基本使用方法

安装配置完成后,AI 助手就可以通过以下工具与你的 Obsidian 笔记交互:

  • 截图功能:获取当前界面的 PNG 或 JPEG 截图
  • 文件操作:读取、写入、搜索笔记内容
  • 插件控制:启用/禁用插件,执行特定命令
  • 实时调试:查看控制台日志,执行 JavaScript 代码
  • DOM 查询:检查 Obsidian 界面元素的状态

例如,你可以让 AI 助手帮你:

  • 搜索特定主题的笔记
  • 截图查看当前工作区状态
  • 执行插件命令来自动化操作

信息

分类

桌面与硬件