如何安装 Obsidian？

推荐在 Claude Code（本地）中安装：1. 确保已安装 Claude Code CLI 2. 复制下方命令，将替换为真实环境变量值后，在终端执行 3. 若下方列出了环境变量，请对照填写命令示例：claude mcp add io-mcp-cn-mcp-obsidian -- npx -y mcp-obsidian

Obsidian 适用于哪些场景？

Obsidian 适用于：国内服务接入。也可在 AgentHub 场景页查看配套 MCP 与 Skill。

Obsidian MCP配置与使用教程

Q: 如何安装 Obsidian？

推荐在 Claude Code（本地） 中安装：1. 确保已安装 Claude Code CLI 2. 复制下方命令，将 替换为真实环境变量值后，在终端执行 3. 若下方列出了环境变量，请对照填写 命令示例：claude mcp add io-mcp-cn-mcp-obsidian -- npx -y mcp-obsidian

MCP ServerMCP Hub 中国

io.mcp-cn.mcp-obsidian

Obsidian的MCP服务器，支持Obsidian的读取和写入

在 MCP Hub 中国查看 ↗

建议先在本页复制安装配置，再到上游核对文档与权限。

热度数据

使用量39.9k

产品介绍

Obsidian的MCP服务器，支持Obsidian的读取和写入 Obsidian 是一个MCP Server，收录自 MCP Hub 中国。支持 stdio 传输。本页提供产品介绍、配置教程、安装命令与适用场景，支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。

ObsidianMCP笔记

适用场景

国内服务接入

AgentHub Verified 可用性验证技术测试通过

自动化测试流水线已校验安装命令、传输协议与客户端兼容性

最近校验时间2026-10-06

安装配置格式测试有效CLI 与 mcpServers JSON 语法校验通过

协议连接与握手响应正常支持标准 JSON-RPC 2.0 规格规范

上游数据源存活来源 mcp-cn，可正常下载依赖

测试可用客户端Claude Code、Claude Desktop、Cursor 等

安全等级： A+ 级 · 零权限本地沙盒 (A+)·该工具经 AgentHub 静态安全特征扫描，无高危越权行为。建议在项目级配置文件中指定工作区范围。

Score 70/100

按平台快速复制

选择你的平台查看安装方式

打开项目根目录下的 .cursor/mcp.json（没有就新建）
点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行

点击「复制配置」直接粘贴到客户端

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

配置教程

打开 Obsidian 详情页，确认这是你需要的 MCP Server（来源 MCP Hub 中国）。
按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code，复制 JSON 配置或 CLI 命令。
将配置合并进 mcpServers，并把环境变量占位符替换为真实密钥。
重载窗口后，在 Agent 对话中调用该 MCP 提供的工具。

安装命令

以下安装命令与配置步骤已写入页面 HTML，搜索引擎与未启用 JavaScript 的浏览器均可直接读取。

Claude Code（本地）

确保已安装 Claude Code CLI
复制下方命令，将 <占位符> 替换为真实环境变量值后，在终端执行
若下方列出了环境变量，请对照填写

claude mcp add io-mcp-cn-mcp-obsidian -- npx -y mcp-obsidian

Cursor — .cursor/mcp.json（本地）

打开项目根目录下的 .cursor/mcp.json（没有就新建）
点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

VS Code — .vscode/mcp.json（本地）

确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
打开项目根目录下的 .vscode/mcp.json（没有就新建）
点击「复制配置」粘贴；若已有其他 MCP，只合并 mcpServers 里的本条目
将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
保存后重新加载 VS Code 窗口

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

Claude Desktop — claude_desktop_config.json（本地）

打开 Claude Desktop 的 claude_desktop_config.json（路径见远程指引）
点击「复制配置」合并到 mcpServers
将 env 中的 <占位符> 替换为真实密钥
完全退出并重启 Claude Desktop

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

Trae — .trae/mcp.json（本地）

打开 Trae → 设置 → MCP，或编辑 .trae/mcp.json / 全局 mcp.json
点击「复制配置」粘贴并合并 mcpServers
将 env 中的 <占位符> 替换为真实密钥
保存后重载 Trae 窗口

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

Cherry Studio — MCP 设置（本地）

打开 Cherry Studio → 设置 → MCP 服务器 → 添加（STDIO）
也可直接导入下方 JSON：点击「复制配置」合并到 mcpServers
将 env 中的 <占位符> 替换为真实密钥，并确保本机已安装 Node.js / uv（npx、uvx）
启用服务并查看工具列表是否加载成功

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

通义灵码 — MCP 配置（本地）

通义灵码：个人设置 → MCP 服务 → 「+」→ 手工添加（STDIO）或配置文件添加
点击「复制配置」合并 mcpServers；命令/参数/环境变量与 JSON 一致
将 env 中的 <占位符> 替换为真实密钥；本机需 Node.js 18+（npx）或已安装 uv（uvx）
确认服务状态为已连接后再在智能体对话中调用

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

Windsurf — mcp_config.json（本地）

编辑 ~/.codeium/windsurf/mcp_config.json
点击「复制配置」合并 mcpServers（本地 stdio 与 Cursor 格式相同）
将 env 中的 <占位符> 替换为真实密钥后保存并刷新 Cascade

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

Cline — MCP Servers（本地）

Cline 面板 → 设置 → MCP Servers
点击「复制配置」粘贴并合并
将 env 中的 <占位符> 替换为真实密钥后保存

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

WorkBuddy — .workbuddy/mcp.json（本地）

编辑 ~/.workbuddy/mcp.json（用户级）或项目目录 .workbuddy/mcp.json
也可在界面：插件 → MCP 服务器 → 配置 MCP，粘贴下方 JSON
将 env 中的 <占位符> 替换为真实密钥；Windows 下 command/脚本路径建议用绝对路径
保存并重启 WorkBuddy，确认连接器状态为绿色

{
  "mcpServers": {
    "io-mcp-cn-mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian"
      ]
    }
  }
}

常见报错排查与运行避坑 (Troubleshooting)FAQ

针对 Obsidian 在 Cursor、Claude Code 中的常见连接错误与解决办法

在 Cursor / Claude Code 中配置 Obsidian 提示 connection closed 或 exit code 1？

通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤： 1. 确认已安装 Node.js 18+（支持 npx）或 Python 3.10+（支持 uvx）； 2. 尝试在终端运行 which npx 或 which uvx，把配置文件中的 "command" 字段改为完整绝对路径； 3. 修改 mcp.json 后，必须完全重载或重启客户端窗口。

Fix Snippet

# 终端测试命令是否存在：
which npx
node -v

提示 spawn npx ENOENT 或 command not found？

这是因为编辑器后台进程未加载完整的终端环境变量（PATH）。解决方案：在全局安装该包（如 npm install -g 包名），或在配置文件中将 command 设置为系统的实际路径（如 Windows 下的 C:\Program Files\nodejs\npx.cmd，Mac 下的 /usr/local/bin/npx）。

调用工具时响应超时或网络下载依赖失败？

国内环境下首次执行 npx 或拉取依赖时可能因网络受限而超时。建议将 npm 镜像源切换为国内高速镜像（npm config set registry https://registry.npmmirror.com），或在系统级开启开发代理工具。

仍连不上？查看 MCP 连接失败排查指南 →

免安装模拟调用 (Playground)

仿真环境

Obsidian 核心接口调用仿真 · 无需配置本地环境，直接预览调用参数与返回格式

沙盒就绪 (Virtual Mock)

fn: io_mcp_cn_mcp_obsidianObsidian的MCP服务器，支持Obsidian的读取和写入

请求入参 (Arguments)JSON Schema

{
  "target": "Obsidian",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}

💡Agent 在规划任务时会自动生成并传递上述入参

Agent Tool Output

点击上方「模拟运行」按钮

查看该工具在 Agent 内部的返回数据格式

测试环境：AgentHub Virtual SandboxJSON-RPC 2.0

选型与决策建议（为什么选它？）

帮助你快速判断该资源是否契合当前项目，避免盲目折腾

适合什么任务？

飞书文档协作
国内地图路线
企业微信通知

什么时候不建议用？

纯海外团队无国内账号
需跨境数据合规评估的场景

推荐工作流搭配：查看完整场景 →

Obsidian + 对应场景 Prompt → 组成标准 Agent 自动化任务

MCP 实战教程：从安装到看见效果

按完整实例走一遍（含期望效果与对比验收）。装完本页资源后，用教程里的提示词核对是否真正生效。

打开教程 →

常搭配使用

电脑装机助手

v0.1.43

SkillClawHub5.1k

io.clawhub.gongyu0918-debug/pc-builder-assistant

用于预算台式机装机规划与推荐、PC 硬件 DIY、升级、配置补全、兼容性检查、硬件指导，以及本地 LLM 的 GPU/显存/内存选型和游戏、直播、创作、美观、紧凑或 ITX 主机配置。内置价格为国内市场人民币参考价；用户显式覆盖时各币种分开处理。支持中文预算装机、装机 DIY、整机推荐、旧机升级、配置补全、搭配或兼容检查、硬件问答等。不适用于笔记本、服务器采购、下单支付、远程控制、安全隔离或独立软件、游戏与智能体教程。

source

在 ClawHub 查看

Danube 受控工具接入

v8.1.20

SkillClawHub5k

io.clawhub.preston-thiele/danube

面向 AI 代理的受治理工具访问——一个 Danube API key 即可解锁你组织自有的工具，外加庞大且持续增长的服务目录，支持 MCP 或 curl；任何写入、发送、消费或删除操作前均需确认。

source

在 ClawHub 查看

微信小程序开发

v1.28.65

SkillClawHub5k

io.clawhub.binggg/miniprogram-development

用于构建、调试、预览、测试、发布和优化小程序项目的小程序设计（开发、调试、预览、发布）。涵盖项目结构与配置（`project.config.json`、`appid`、`miniprogramRoot`、`tabBar`、路由/导航、图标资源）、微信开发者工具 Nightly 工作流（`wechatide` CLI、WeChat IDE Skills/MCP）、`miniprogram-ci` 预览/上传、控制台/网络调试、消息推送与客服消息自动回复、小程序搜索优化/收录（页面收录、搜索推广、mpcrawler），以及 CloudBase 集成（`wx.cloud`、腾讯云开发、云开发）。当用户创建、开发、修改、调试、预览、部署、发布或推广微信小程序时使用。不适用于 Web 前端（用 web-development）、纯后端服务（用 cloudrun-development / cloud-functions）或纯 UI 设计任务（用 ui-design）。

source

在 ClawHub 查看

Ach Publish

v3.0.25

SkillClawHub4.1k

io.clawhub.liuboacean/agent-comm-hub

本地多智能体通信 Hub（MCP stdio / HTTP-SSE），提供消息、任务编排、共享记忆、进化引擎，暴露 58 个 MCP 工具 + Web 管理面板

source

在 ClawHub 查看

继续逛 AgentHub

大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。

浏览更多同类搜索相似资源按场景选型场景提示词 MCP 实战教程评测与对比

收录徽章：把 AgentHub 挂到你的官网

复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链，无需上传文件，链接指向本页，访客可由此直接找到安装方式。

预览

HTML

<a href="https://myagenthub.cn/p/io.mcp-cn.mcp-obsidian" title="AgentHub 已收录：Obsidian" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.mcp-cn.mcp-obsidian" alt="AgentHub 已收录：Obsidian" height="20" style="border:0"/>
</a>

Markdown（GitHub README）

[![AgentHub 已收录：Obsidian](https://myagenthub.cn/badge/io.mcp-cn.mcp-obsidian)](https://myagenthub.cn/p/io.mcp-cn.mcp-obsidian)

徽章由 /badge/<资源ID> 动态生成，名称与收录状态变化后自动更新；请保留链接指向，它是收录来源的判定依据。

统一 Manifest

{
  "id": "io.mcp-cn.mcp-obsidian",
  "type": "mcp-server",
  "version": "latest",
  "displayName": "Obsidian",
  "description": "Obsidian的MCP服务器，支持Obsidian的读取和写入",
  "author": {
    "name": "Henry Mao"
  },
  "iconUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQGpiHGQgbhtPgCcf7nNhSR14ckMAkfH2TCwQ&s",
  "homepage": "https://mcp-cn.com/server/101",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "mcp-obsidian",
        "runtimeHint": "npx",
        "transport": "stdio"
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [
    "use_count:39865",
    "Obsidian",
    "MCP",
    "Obsidian",
    "笔记"
  ],
  "provenance": {
    "origin": "mcp-cn",
    "originalId": "mcp-obsidian",
    "originalUrl": "https://mcp-cn.com/server/101",
    "isOfficial": false,
    "status": "active"
  }
}

热度数据

使用量: 39.9k

资源信息

作者: Henry Mao
发布时间: 2025年6月3日
更新时间: 2026年10月1日

客户端接入与实战

MCP 实战教程（含效果验收）→Cursor 5分钟配置 MCP→Claude Code 安装与调试→探索全套工作流场景→

支持平台

Claude CodeClaude DesktopCursorVS CodeTraeCherry Studio通义灵码WindsurfClineWorkBuddy

分发方式

npmstdiomcp-obsidian

来源

Registry: MCP Hub 中国
状态: active

数据来自上游 registry，收录不代表安全审计。安装前请自行确认来源可信。

Obsidian MCP配置与使用教程

产品介绍

适用场景

AgentHub Verified 可用性验证技术测试通过

按平台快速复制

配置教程

常见报错排查与运行避坑 (Troubleshooting)FAQ

免安装模拟调用 (Playground)

选型与决策建议（为什么选它？）

相关资源

Flomo

gosidian

顺序思考

n8n

Playwright

GitHub

常搭配使用

电脑装机助手

Danube 受控工具接入

微信小程序开发

Ach Publish

继续逛 AgentHub

收录徽章：把 AgentHub 挂到你的官网

统一 Manifest