Obsidian MCP Server
2025.02.17
0
TypeScript知识管理AI集成开发效率
Obsidian MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专为大型语言模型 (LLMs) 与 Obsidian 知识库交互而设计。它使用 TypeScript 构建，提供安全的 API 通信、高效的文件操作和全面的搜索功能，使 AI 助手能够通过简洁灵活的工具界面无缝管理知识库。
View on GitHub
Overview
基本能力
产品定位
Obsidian MCP Server 是一个连接大型语言模型与 Obsidian 知识库的中间件服务，旨在通过标准化接口实现 AI 与知识管理系统的深度集成。
核心功能
- 文件操作
- 原子性文件/目录操作与验证
-
资源监控与清理
-
搜索系统
- 可配置上下文的全文搜索
- 支持 JsonLogic 高级查询（文件、标签和元数据）
-
支持 glob 模式和 frontmatter 字段
-
属性管理
- YAML frontmatter 解析与智能合并
- 自动时间戳管理
-
自定义字段支持
-
安全与性能
- API 密钥认证与速率限制
- SSL 选项支持
- 资源监控与健康检查
适用场景
- AI 助手管理 Obsidian 知识库
- 自动化知识整理与分类
- 智能搜索与内容提取
- 批量元数据管理
工具列表
- 文件管理工具
- 列出保险库内容
- 获取文件内容
-
目录内容浏览
-
搜索操作工具
- 带上下文的文本搜索
-
基于 JsonLogic 的高级搜索
-
内容修改工具
- 文件内容追加
-
文件内容替换
-
命令管理工具
- 列出可用命令
-
执行特定命令
-
文件导航工具
- 在 Obsidian 中打开文件
- 获取活动文件内容
-
获取周期性笔记
-
属性管理工具
- 获取所有标签
- 获取/更新笔记属性
常见问题解答
- 需要先在 Obsidian 中启用 Local REST API 插件
- Windows 用户需要特别注意 SSL 证书配置
- 所有错误都包含 5 位错误代码便于诊断
使用教程
使用依赖
- 安装 Node.js (推荐 LTS 版本)
- 在 Obsidian 中启用 Local REST API 插件
安装教程
- 克隆并构建:
git clone [email protected]:cyanheads/obsidian-mcp-server.git
cd obsidian-mcp-server
npm install
npm run build
或通过 npm 安装:
npm install obsidian-mcp-server
调试方式
- 检查环境变量配置是否正确
- 验证 API 密钥是否有效
- 检查 Obsidian Local REST API 是否正常运行
- 使用以下命令测试连接:
curl -X GET "http://127.0.0.1:27124/vault" -H "Authorization: Bearer your_api_key"