返回 MCP 目录
public公开dns本地运行

Obsidian iCloud

Obsidian iCloud MCP是一个通过模型上下文协议(MCP)将存储在iCloud Drive中的Obsidian知识库连接到AI的工具,主要支持MacOS系统。

article

README

🚀 Obsidian iCloud MCP

Obsidian iCloud MCP 能够将存储在 iCloud Drive 中的 Obsidian 保险库连接到 AI,并通过模型上下文协议(MCP)进行通信。

🚀 快速开始

与 Claude Desktop 配合使用

将以下内容添加到您的claude_desktop_config.json中:

调试开发版本

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp/build/index.js",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_1>",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_2>"
      ]
    }
  }
}

使用npx @modelcontextprotocol/inspector node path/to/server/index.js arg1 arg2 arg3 arg...来本地检查开发中的服务器。

生产环境使用

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_1>",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_2>"
      ]
    }
  }
}

⚠️ 重要提示

Obsidian iCloud MCP 已在 MacOS 上全面测试。如果您使用的是 Windows 或 Linux,请自行测试并告知我结果。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端