Obsidian MCP 连接器
通过模型上下文协议（MCP），将您的Obsidian知识库连接到AI助手和自动化工具。此插件使您的知识库与MCP兼容的客户端（如Claude Code）之间实现无缝集成。
为什么要使用这个插件？
🎯 智能上下文，最少标记数
精确胜于蛮力
- 手术取出不要把你所有的资料都一股脑儿地塞给AI，而应该精准地只针对那些重要的笔记
- 查询驱动的智能利用Dataview的强大查询语言，精准提取所需内容——不多不少
- 代币优化通过获取与上下文相关的内容，而非整个知识库，大幅减少令牌消耗
- 元数据驱动的过滤利用标签、日期、优先级和自定义字段，以极高的精确度定位信息
《The Difference》（中文可译为《差异》或《不同》）与其将1000多条笔记一股脑儿地输入到AI的上下文窗口中（这样会消耗令牌并分散注意力），不如直接提问“给我展示本季度的高优先级项目笔记”，这样你只会收到那10条真正相关的文档。你的AI助手将保持专注、响应迅速且成本效益高。
🚀 深刻变革性的益处
- AI驱动的知识协同/整合将您的知识库从静态存储升级为智能、可查询的知识系统
- 精通复杂任务通过自然对话创建和管理包含丰富元数据的复杂任务层级
- Dataview Synergy（数据视图协同）无需纠结复杂语法，即可解锁结构化查询的全部功能
- 通用平台支持在Windows、macOS、Linux和Android系统上无缝操作——甚至在移动设备上也能完全自给自足
- 隐私优先架构保持你的知识神圣不可侵犯——所有操作都在本地运行，完全不依赖云端
- 经过实战检验的可靠性享受强大的自动重连功能和优雅的错误处理，确保工作流程不间断
主要特点
任务管理
- ✅ 支持数据视图元数据的完整CRUD操作
- ✅ 优先级、截止日期、标签和自定义字段
- ✅ 自动生成唯一任务ID以进行追踪
- ✅ 重复任务和事件安排
- ✅ 智能搜索，支持按文本、优先级、标签和日期
- ✅ 带有适当缩进的子任务管理
数据视图集成
- ✅ 执行TABLE、LIST和TASK查询
- ✅ 访问页面元数据和内联字段
- ✅ 使用 WHERE/FROM/SORT 子句进行复杂过滤
- ✅ 结构化和Markdown输出格式
保险库运营
- ✅ 列出、阅读和搜索笔记
- ✅ 文件元数据访问
- ✅ 基于路径的组织方式
- ✅ 全文搜索功能
它是如何工作的
该插件使用了一个 统一的WebSocket架构 这适用于所有平台：
MCP Client (Claude Code) ←→ Bridge Server ←→ Obsidian Plugin ←→ Your Vault
(HTTP/MCP) (WebSocket) (Obsidian API)- 桥接服务器 本地运行，并在HTTP/MCP和WebSocket协议之间进行转换
- Obsidian 插件 连接到桥梁并以MCP工具的形式暴露（或提供）地堡（或保险库）操作功能
- MCP 客户端 像Claude Code这样，然后可以通过自然语言与您的保险库进行交互
支持的平台：
- ✅ Windows、macOS、Linux（全面支持桌面环境）
- ✅ Android（使用Termux实现自包含）
- ⚠️ iOS（需要外部桥接服务器）
快速入门
选项A：自动化安装（推荐）
使用安装脚本来自动下载、构建和安装：
# Linux/Mac - from your vault directory
cd /path/to/your/vault
curl -O https://raw.githubusercontent.com/Prashanth-BC/mcp-connector-for-obsidian/main/install.sh
chmod +x install.sh
./install.sh
# Or specify vault path
./install.sh /path/to/your/vault
# Windows - from your vault directory
cd C:\path\to\your\vault
curl -O https://raw.githubusercontent.com/Prashanth-BC/mcp-connector-for-obsidian/main/install.cmd
install.cmd
# Or specify vault path
install.cmd C:\path\to\your\vault然后在Obsidian设置中启用插件 → 社区插件 → MCP连接器
选项B：手动安装
# Build the plugin
npm ci
npm run build
# Copy to your vault
cp -r mcp-connector /path/to/vault/.obsidian/plugins/在Obsidian设置中启用插件 → 社区插件 → MCP连接器
2. 启动工作区
在一个命令中同时启动桥接服务器和Claude Code：
# Linux/Mac (uses tmux)
cd /path/to/your/vault
./start-mcp-workspace.sh
# Windows (uses Windows Terminal or separate windows)
cd C:\path\to\your\vault
start-mcp-workspace.cmd工作区启动器会自动为Claude Code配置MCP连接。现在，您可以向您的AI助手提出以下请求：
- “列出我所有高优先级的任务”
- “在我的笔记中搜索有关机器学习的参考资料”
- “创建一项任务，要求在周五前审查项目计划”
- “显示‘项目’文件夹中的所有笔记”
用例
针对知识工作者
- 人工智能辅助研究让AI助手帮助您探索并连接您知识库中的各种想法
- 智能任务管理使用自然语言创建和组织任务
- 自动化工作流构建与您的笔记交互的自动化脚本
对于开发者
- 项目文档以编程方式查询项目笔记和技术文档
- 问题跟踪使用丰富的元数据管理开发任务
- 代码集成将您的代码与您的知识库连接起来
对于学生
- 学习管理追踪作业分配、阅读材料和截止日期
- 研究机构高效查询并整理研究笔记
- 音符合成让AI帮助你在笔记之间建立概念联系
文档
发展
建筑；建筑物
# Install dependencies
npm ci
# Build once
npm run build
# Watch for changes
npm run watch测试
npm test项目结构
src/
├── main.ts # Main plugin entry point
├── mcp-websocket.ts # WebSocket transport
├── plugin-bridge.ts # Tool registration and routing
├── settings.ts # Plugin settings UI
└── tools/ # Tool adapters
├── mcp-http-ws-bridge.js # Bridge server
├── dataview.ts # Dataview integration
└── tasks.ts # Task management贡献；助力
欢迎投稿！无论是：
- 🐛 错误报告和修复
- ✨ 功能需求和实现
- 📚 文档改进
- 🧪 测试覆盖率增强
请随时提出问题或提交拉取请求。
许可证
此项目遵循GNU通用公共许可证第3版或更高版本（GPL-3.0或更高版本）进行授权。
摘要：
- ✅ 免费运行、学习、分享和修改代码
- ✅ 根据GPL-3.0或更高版本分发包含源代码的修改版本
- ❌ 施加与GPL相悖的额外限制
如需了解其他许可安排，请联系我们探讨双重许可选项。
致谢
构建于：
- 黑曜石 - 可扩展的知识库
- 模型上下文协议 - 人工智能集成标准
- Dataview（数据视图） - 适用于Obsidian的强大查询引擎