AI导哈

Obsidian MCP 服务器

Obsidian MCP 服务器是一个模型上下文协议（MCP）服务器，使AI助手（如Claude）能够与您的Obsidian知识库进行交互。该服务器通过Local REST API插件提供读取、创建、搜索和管理Obsidian笔记的工具。

  • by natestrong
  • 1 星标
  • 更新于
在 GitHub 查看 natestrong/obsidian-mcp

使用说明

基本能力

产品定位

Obsidian MCP 服务器是一个连接AI助手与Obsidian知识库的桥梁，提供丰富的笔记管理功能。

核心功能

  • 📖 读取和写入笔记 - 完全访问您的Obsidian知识库，并具有自动覆盖保护功能
  • 🔍 智能搜索 - 通过内容、标签或修改日期查找笔记
  • 📁 浏览知识库 - 按目录列出和导航笔记
  • 🏷️ 标签管理 - 在frontmatter中添加、删除和组织标签
  • 📊 笔记洞察 - 获取字数统计和链接分析等统计信息
  • 🎯 AI优化 - 清晰的错误消息和智能默认设置，以改善AI交互
  • 🔒 安全 - 使用API密钥认证，仅限本地连接

适用场景

  • AI助手与个人知识库交互
  • 自动化笔记管理和组织
  • 智能搜索和数据分析
  • 批量处理笔记内容

使用教程

使用依赖

  1. 安装并配置Obsidian，安装Local REST API插件
  2. 确保系统已安装Python 3.10+
  3. (可选)安装Node.js以运行MCP Inspector

安装教程

快速安装

  1. 在Obsidian中安装并配置Local REST API插件
  2. 配置您的AI工具（Claude Desktop、Cursor IDE或Windsurf IDE）
  3. 重启AI工具以加载新配置

开发安装

  1. 克隆仓库:
git clone https://github.com/natestrong/obsidian-mcp
cd obsidian-mcp
  1. 设置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
  1. 安装依赖:
pip install -r requirements.txt
  1. 设置Obsidian Local REST API
  2. 配置环境变量

调试方式

运行测试

# 运行所有测试
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

  1. 确保Obsidian正在运行并启用了Local REST API插件
  2. 运行MCP Inspector:
npx @modelcontextprotocol/inspector python -m src.server
  1. 在http://localhost:5173打开Inspector UI
  2. 与您的实际知识库交互测试工具

相关 MCP