基本能力
产品定位
Obsidian MCP 服务器是一个连接AI助手与Obsidian知识库的桥梁，提供丰富的笔记管理功能。
核心功能
- 📖 读取和写入笔记 - 完全访问您的Obsidian知识库，并具有自动覆盖保护功能
- 🔍 智能搜索 - 通过内容、标签或修改日期查找笔记
- 📁 浏览知识库 - 按目录列出和导航笔记
- 🏷️ 标签管理 - 在frontmatter中添加、删除和组织标签
- 📊 笔记洞察 - 获取字数统计和链接分析等统计信息
- 🎯 AI优化 - 清晰的错误消息和智能默认设置，以改善AI交互
- 🔒 安全 - 使用API密钥认证，仅限本地连接
适用场景
- AI助手与个人知识库交互
- 自动化笔记管理和组织
- 智能搜索和数据分析
- 批量处理笔记内容
使用教程
使用依赖
- 安装并配置Obsidian，安装Local REST API插件
- 确保系统已安装Python 3.10+
- (可选)安装Node.js以运行MCP Inspector
安装教程
快速安装
- 在Obsidian中安装并配置Local REST API插件
- 配置您的AI工具（Claude Desktop、Cursor IDE或Windsurf IDE）
- 重启AI工具以加载新配置
开发安装
- 克隆仓库:
git clone https://github.com/natestrong/obsidian-mcp
cd obsidian-mcp- 设置Python环境:
# 使用pyenv（推荐）
pyenv virtualenv 3.12.9 obsidian-mcp
pyenv activate obsidian-mcp
# 或使用venv
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate- 安装依赖:
pip install -r requirements.txt- 设置Obsidian Local REST API
- 配置环境变量
调试方式
运行测试
# 运行所有测试
python tests/run_tests.py
# 运行特定测试类型
python tests/run_tests.py unit
python tests/run_tests.py integration
python tests/run_tests.py live使用MCP Inspector
- 确保Obsidian正在运行并启用了Local REST API插件
- 运行MCP Inspector:
npx @modelcontextprotocol/inspector python -m src.server- 在
http://localhost:5173打开Inspector UI - 与您的实际知识库交互测试工具