项目简介
Obsidian CDP MCP 服务器是一个专门为 Obsidian 笔记软件设计的 MCP 服务,通过 Chrome DevTools 协议实现对 Obsidian 的深度控制,相比传统 REST API 提供了更多高级功能。
主要功能
- 文件管理:读取、写入、搜索和打开笔记文件
- 界面操作:实时截图、获取控制台输出、查询 DOM 元素
- 插件系统:列出和管理所有插件,执行任意命令
- 高级调试:执行 JavaScript 代码,访问完整的 Obsidian API
- 实时监控:捕获 Obsidian 的控制台日志和错误信息
安装步骤
-
确保 Obsidian 处于调试模式:
- macOS:'open -a Obsidian --args --remote-debugging-port=9222'
- 其他系统:启动 Obsidian 时添加 '--remote-debugging-port=9222' 参数
-
安装服务器:
- 使用 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 助手帮你:
- 搜索特定主题的笔记
- 截图查看当前工作区状态
- 执行插件命令来自动化操作
信息
分类
桌面与硬件