Obsidian-MCP-Server

轻松将Claude AI集成到您的Obsidian保险库中！本指南提供在Windows 11上设置模型上下文协议（MCP）服务器的简单步骤，使Claude能够直接协助您在Obsidian中的头脑风暴、笔记记录和知识管理。

Obsidian AI 集成：为Claude Desktop 设置MCP服务器

本指南提供了在Windows 11上设置Obsidian 模型上下文协议（MCP）服务器的逐步说明。此服务器充当桥梁，允许外部AI应用程序如Claude Desktop安全地读取和写入您的Obsidian保险库，解锁强大的AI驱动工作流程，直接与您的笔记互动。

---

目录

• 为什么使用Obsidian MCP服务器？
• 前提条件
• 逐步设置指南
  • 阶段1：准备您的Obsidian保险库
  • 阶段2：配置Claude Desktop以启动MCP服务器
• 常见问题排查
  • 没有生成mcp-debug.log文件
  • claude_desktop_config.json语法错误
  • 仅显示已存在的MCP服务器（例如Blender）
  • API密钥或保险库路径错误
  • 日志中的服务器错误（例如“地址已被使用”）
  • 一般连接问题 / Claude未识别配置
• 贡献
• 许可

---

为什么使用Obsidian MCP服务器？

模型上下文协议（MCP）服务器赋予AI模型以下能力：

• 阅读您的笔记： 访问您的保险库内容进行总结、深入分析和上下文理解。
• 创建和修改笔记： 根据您的AI提示生成新想法、草拟内容或更新现有文件。
• 搜索您的保险库： 在您的知识库中进行全面搜索，找到与AI任务相关的信息，使您的知识真正智能化。

这种集成特别有用，当您希望像Claude Desktop这样的独立AI应用程序直接与您的知识库交互时，通常比单独的Obsidian插件提供更深入和无缝的交互。

---

前提条件

开始之前，请确保您具备以下条件：

• 已安装Obsidian： 您希望与AI集成的活动Obsidian保险库。
• Node.js（版本20或更高）： MCP服务器运行于Node.js之上。
  • 检查您的版本： 打开PowerShell并运行：node -v
  • 如果您没有安装Node.js或版本较旧，请从nodejs.org下载并安装最新LTS（长期支持）版本。
• Claude Desktop： 您将连接的AI应用程序。

---

逐步设置指南（Windows 11）

请仔细遵循以下说明，将您的Obsidian MCP服务器与Claude Desktop集成。

阶段1：准备您的Obsidian保险库

此阶段设置了一个关键的Obsidian社区插件，该插件启用对您的保险库的安全外部访问。

1. 打开您的Obsidian保险库： 启动Obsidian并打开您希望AI与其交互的具体保险库。
2. 进入设置： 点击Obsidian窗口左下角的齿轮图标（设置）。
3. 导航至社区插件： 在设置侧边栏中，点击社区插件。
4. 关闭受限模式： 如果启用了“受限模式”，将其切换为关闭。如果提示确认操作，请确认。
5. 浏览插件： 点击“社区插件”旁边的浏览按钮。
6. 搜索“本地REST API”： 在搜索栏中键入本地REST API。
7. 安装插件： 查找“本地REST API”插件（由pjeby开发），并点击安装。
8. 启用插件： 安装完成后，点击启用按钮。
9. 配置本地REST API并生成API密钥：
   • 在社区插件列表中，找到“本地REST API”。
   • 点击其旁边的齿轮图标（或“选项”按钮）以访问其设置。
   • 找到生成新的API密钥部分，并点击按钮。
   • 至关重要的是立即复制生成的API密钥。 此密钥非常敏感，授予访问您的保险库权限。请像对待密码一样对待它；不要公开分享。您将在下一阶段需要它。

阶段2：配置Claude Desktop以启动MCP服务器

在此阶段，您将配置Claude Desktop以自动启动和管理Obsidian MCP服务器，每当Claude Desktop启动时。

1. 完全关闭Claude Desktop： 确保应用程序完全关闭，而不仅仅是最小化到系统托盘。如有必要，请使用任务管理器（Ctrl+Shift+Esc），在“应用”或“后台进程”部分查找“Claude”，右键选择“结束任务”。

2. 定位Claude Desktop的配置文件：

   • 打开文件资源管理器。
   • 在地址栏中键入：%APPDATA%\Claude\ 并按回车。
   • 您应该在此文件夹中直接找到名为claude_desktop_config.json的文件。如果不存在，请创建一个具有此确切名称的新纯文本文件。

3. 编辑配置文件：

   • 使用纯文本编辑器（如记事本、VS Code、Notepad++）打开claude_desktop_config.json。
   • 重要： 如果您已有现有配置（例如Blender MCP服务器），您将在其旁边添加Obsidian条目，用逗号分隔。
   • 添加或修改mcpServers部分以包含您的Obsidian MCP服务器配置：

   {
     "mcpServers": {
       "obsidian": { // 您可以给这个任何名字，“obsidian”是描述性的。
         "command": "npx",
         "args": ["-y", "obsidian-mcp", "YOUR_OBSIDIAN_VAULT_PATH_HERE"],
         "env": {
           "OBSIDIAN_API_KEY": "YOUR_ACTUAL_OBSIDIAN_API_KEY_HERE"
         }
       }
       // 如果您有其他服务器（如Blender），它们将在此列出，
       // 用逗号与“obsidian”条目分开，如下所示：
       // "anotherServerName": { ... },
       // "obsidian": { ... }
     }
   }
   

   • 上述配置的关键点：
     • 将YOUR_OBSIDIAN_VAULT_PATH_HERE替换为您系统中精确、完整的绝对路径到您的Obsidian保险库文件夹。
       • Windows示例： "C:/Users/YourUser/Documents/MyVault"（使用正斜杠，通常推荐在JSON中）
       • 另一种方式（Windows）： "C:\\Users\\YourUser\\Documents\\MyVault"（使用双反斜杠）
     • 将YOUR_ACTUAL_OBSIDIAN_API_KEY_HERE替换为在阶段1第9步中复制的确切API密钥。这是一个长字符串。
   • 保存claude_desktop_config.json文件。

4. 验证JSON语法：

   • 复制您修改后的claude_desktop_config.json文件的整个内容。
   • 转到在线JSON验证器如jsonlint.com。
   • 将您的JSON粘贴到验证器中并点击“验证JSON”。必须显示“有效JSON”。 如果显示任何错误（例如“缺少逗号”、“错误字符串”），请在您的claude_desktop_config.json文件中准确修复这些错误并再次保存。

5. 重启Claude Desktop： 启动Claude Desktop。允许一两分钟的时间让其完全加载并尝试启动MCP服务器。

一旦Claude Desktop启动，现在应该能够与您的Obsidian保险库通信了！查看Claude Desktop界面中是否显示识别到了Obsidian服务器的指示。

---

常见问题排查

以下是设置过程中遇到的一些常见问题及其解决方案：

• 没有生成mcp-debug.log文件：

  • 这表明Claude Desktop甚至没有尝试启动MCP服务器或处理其输出。
  • 验证claude_desktop_config.json位置： 确保文件名确切为claude_desktop_config.json，且位于%APPDATA%\Claude\目录下，没有子文件夹。
  • 验证claude_desktop_config.json语法： 单个语法错误（例如缺少逗号、大括号或引号）将阻止Claude读取整个文件。使用jsonlint.com来验证整个文件。
  • 执行Claude Desktop的强制重启： 使用任务管理器（Ctrl+Shift+Esc）“结束任务”所有Claude进程，然后重新启动。

• claude_desktop_config.json语法错误：

  • 使用JSON验证器： 每次更改后，始终复制您整个claude_desktop_config.json的内容并粘贴到jsonlint.com中。它会指出确切的语法错误。

  • 缺失逗号： 如果您在mcpServers中有多个服务器（例如blender和obsidian），每个条目（除了最后一个）都必须用逗号分隔。

    "server1": { ... },  <-- 这里需要逗号
    "server2": { ... }
    

• 仅显示已存在的MCP服务器（例如Blender）：

  • 当您覆盖了现有配置或引入了阻止新条目被解析的语法错误时会发生这种情况。
  • 确保正确的JSON结构： 添加新服务器时，确保它是mcpServers对象内的新键值对，并且与前一个条目用逗号分隔。参考阶段2，步骤3中的示例。

• API密钥或保险库路径错误：

  • 即使生成了mcp-debug.log，这些错误通常也会出现在其中。
  • API密钥： 双重检查claude_desktop_config.json中的OBSIDIAN_API_KEY是否与在Obsidian的“本地REST API”插件设置中生成的密钥完全匹配。确保在复制粘贴时没有额外空格或遗漏字符。
  • 保险库路径： 确认路径YOUR_OBSIDIAN_VAULT_PATH_HERE是到您的Obsidian保险库文件夹的精确、绝对路径。确认正确的斜杠使用：C:/path/to/vault（正斜杠）或C:\\path\\to\\vault（双反斜杠）在JSON字符串中。

• 日志中的服务器错误（例如“地址已被使用”）：

  • 如果mcp-debug.log显示MCP服务器尝试启动但因类似“地址已被使用”的错误失败，端口27123：
  • 另一个应用程序（或MCP服务器的先前实例）正在使用该端口。
  • 解决方案： 您可以尝试配置obsidian-mcp服务器使用不同的端口。
    • 在claude_desktop_config.json中，修改obsidian服务器的args数组：

      "args": ["-y", "obsidian-mcp", "YOUR_OBSIDIAN_VAULT_PATH_HERE", "--port", "27124"],
      

    • 然后，执行Claude Desktop的强制重启。

• 一般连接问题 / Claude未识别配置：

  • 如果一切看起来正确但Claude仍然无法识别服务器：
  • 强制重启Claude Desktop： 如在故障排除期间发现，有时标准重启不够。使用任务管理器（Ctrl+Shift+Esc）确保所有“Claude”进程结束后再重新启动。
  • 重新安装Claude Desktop（最后手段）： 如果所有方法都无效，请考虑卸载并重新安装Claude Desktop。

---

贡献

如果您遇到新问题、有改进意见或找到了更清晰的解释步骤，请随时提出问题或提交拉取请求！您的贡献有助于其他人。

---

额外的故障排除/重要提示

有时，Claude可能无法连接到服务器，如果出现此问题，请在任务管理器中结束所有Claude任务，然后重新打开它，这样就可以解决问题。

---

许可

本指南根据MIT许可提供。