Obsidian MCP Server

什么是 Obsidian MCP 服务器?

Obsidian MCP 服务器是一个轻量级服务器，通过标准化的 MCP 接口将你的本地 Obsidian 保险库及其数据暴露给大型语言模型和 AI 工具。它利用 Obsidian 本地 REST API 插件，安全地与文件、目录和笔记内容交互，使得高级 AI 工作流可以轻松搜索、检索、编辑和管理你的笔记。

如何配置 Obsidian MCP 服务器

1. 安装 Obsidian 本地 REST API 插件
   在 Obsidian 内下载并启用社区插件，然后从配置面板复制 API 密钥。
2. 配置 MCP 服务器环境
   a. 优先：编辑服务器配置以包含环境变量：

   {
     "mcp-obsidian": {
       "command": "uvx",
       "args": ["mcp-obsidian"],
       "env": {
         "OBSIDIAN_API_KEY": "<你的_api_key>",
         "OBSIDIAN_HOST": "<你的_obsidian_host>"
       }
     }
   }
   

   b. 另外，可以创建一个 .env 文件：

   OBSIDIAN_API_KEY=你的_api_key
   OBSIDIAN_HOST=你的_obsidian_host
   

3. 与 AI 环境集成
   为 Obsidian MCP 服务器添加配置到你的 LLM 或代理主机（例如，Claude Desktop），以便它可以连接到正在运行的服务器。

如何使用 Obsidian MCP 服务器

• 在配置访问凭证后启动 Obsidian MCP 服务器。
• 在你的 LLM 环境中使用自然语言指令请求数据或操作，例如：
  • "总结上次会议的笔记，并创建新的总结笔记。"
  • "搜索讨论 Azure CosmosDb 的文件。"
  • "获取文件的内容并附加一个介绍。"
• LLM 将自动发现并调用 Obsidian 服务器提供的工具来执行请求的操作。
• 高级用户可以直接调用特定工具，例如，以编程方式列出文件或编辑笔记内容。

主要特点

• 与 LLM 或 AI 代理的无缝交互
• 提供丰富的文件和内容操作功能，包括搜索、阅读、编辑、创建和删除笔记
• 通过 API 密钥认证，与本地数据的安全且可配置的连接
• 灵活集成 Claude Desktop 和其他支持 MCP 的 AI 主机
• 可扩展：轻松添加更多工具或自定义现有工具以符合你的工作流

使用案例

• 自动化会议笔记的总结和结构化跟进笔记
• 快速搜索和上下文检索笔记及知识片段以便快速参考
• 自动生成并附加总结、介绍或 AI 生成的内容到现有笔记
• 使用 LLM 以编程方式管理和组织大型保险库
• 编写高级工作流脚本，如每日笔记创建、知识库策划或团队文档更新

常见问题

Q1: 我需要将整个保险库暴露给互联网才能使用 Obsidian MCP 服务器吗？
不需要，服务器通过本地 REST API 安全地连接到你的本地 Obsidian 实例；除非你显式连接到远程服务，否则你的保险库会保留在设备上。

Q2: 使用 Obsidian MCP 服务器和 LLM 时我的数据安全吗？
你的笔记仅在本地（或通过你指定的网络）访问，并由你的 Obsidian API 密钥保护。始终检查访问凭证和服务器配置以确保安全部署。

Q3: 我可以将 Obsidian MCP 服务器与其他语言模型或工具一起使用吗？
可以，任何支持 MCP 的 LLM 或代理平台都可以连接并利用 Obsidian MCP 服务器。

Q4: 如果我想添加更多操作或自定义功能怎么办？
服务器是可扩展的—它的源代码允许开发者添加自定义工具或修改当前工具，以进一步调整集成。

Q5: 这与现有的 Obsidian 插件和工作流兼容吗？
是的，Obsidian MCP 服务器作为额外层访问你的笔记，通过标准 REST API，与现有插件和笔记结构兼容。