MCP server for Obsidian

MCP server for Obsidian

通过 Obsidian 的 REST API 社区插件与 Obsidian 交互的 MCP Server。

GitHub
Created ByMarkusPfundsteinMarkusPfundstein

Obsidian MCP 服务器 - 快速开始指南

Obsidian MCP 服务器

简介

MCP 服务器让 Claude 能够与您的 Obsidian 仓库互动，实现文件检索、搜索和内容修改等功能。

安装步骤

1. 安装 Obsidian 插件

  1. 在 Obsidian 中安装 Local REST API 社区插件
  2. 启用插件并复制生成的 API 密钥

2. 配置 Claude Desktop

根据您的操作系统，编辑 Claude 配置文件：

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

使用指南

与 Claude 交流时，建议首先指示它使用 Obsidian，确保它调用正确的工具。

可用功能

  • 浏览仓库文件和目录
  • 检索文件内容
  • 搜索仓库内容
  • 更新现有笔记
  • 创建新笔记

示例提示

  • "获取我上次会议记录并总结要点"
  • "搜索所有提到项目计划的文件"
  • "创建一个新笔记，总结我的研究成果"

调试指南

查看服务器日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log

使用 MCP Inspector 进行高级调试：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian

更多详细信息请访问 项目页面。