/ 目录 / 演练场 / Claude × Obsidian
● 社区 AgriciDaniel ⚡ 即开即用

Claude × Obsidian

作者 AgriciDaniel · AgriciDaniel/claude-obsidian

将你的 Obsidian 知识库变成自我维护的 wiki——Claude 保存重要内容、建立链接、不断丰富知识图谱,而不是让笔记沉入虚空。

以 Andrej Karpathy「LLM Wiki」模式实现的 Claude Code skill。三个命令:/wiki 向知识库提问(自动链接到已有笔记)、/save 将对话片段存为带交叉链接的结构化笔记、/autoresearch 深入调研某个话题并生成有来源支撑的 wiki 条目。设计目标是让知识积累,而非堆砌。

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-obsidian-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-obsidian-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-obsidian",
          "~/.claude/skills/claude-obsidian"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add claude-obsidian-skill -- git clone https://github.com/AgriciDaniel/claude-obsidian ~/.claude/skills/claude-obsidian

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Claude × Obsidian

如何将一段长 Claude 对话存为一条正式 wiki 条目

👤 使用 Obsidian 的知识工作者 ⏱ ~5 min beginner

何时使用: 你刚进行了一次有价值的 Claude 对话,以后还会用到——不要让它消失在聊天历史中。

前置条件
  • skill 已安装;知识库路径已配置 — 在环境变量中设置 OBSIDIAN_VAULT;通过 git clone 安装
步骤
  1. 保存
    /save the conversation we just had about React Server Components patterns. Title: 'RSC patterns'.✓ 已复制
    → 笔记已在 /Wiki/RSC-patterns.md 创建,带 frontmatter + 反链
  2. 验证链接
    Show me what existing notes the new entry links back to.✓ 已复制
    → 已链接的笔记列表,附链接理由

结果: wiki 获得结构化条目,而不是让对话消失在 dev/null。

注意事项
  • /save 生成的笔记过长 — skill 默认压缩到约 600 字;仅在真正需要时传入 --full
搭配使用: obsidian-mcp-tools

先问 wiki,再问模型

👤 知识库积累了一段时间的用户 ⏱ ~5 min beginner

何时使用: 你知道自己写过这方面的内容;先查知识库。

步骤
  1. 查询 wiki
    /wiki What did I conclude about RSC error boundaries last quarter?✓ 已复制
    → 引用 + 源笔记链接
  2. 精炼
    Now extend that conclusion with anything you can verify online today, and update the note.✓ 已复制
    → 笔记已更新,新增带日期的章节

结果: 知识库越来越密集,而不是越来越重复。

注意事项
  • wiki 中的信息已过时,但没有及时更新 — skill 将超过 6 个月未修改的笔记标记为过时;召回时提示审查

运行 /autoresearch,为某个话题添加有来源的 wiki 条目

👤 研究者、学生 ⏱ ~30 min intermediate

何时使用: 这个话题对你来说是新的;你想要一份后续可以不断扩展的笔记式总结。

步骤
  1. 自动调研
    /autoresearch 'Mixture of Experts in 2026 — recent open-source results'.✓ 已复制
    → 笔记已创建,含章节、引用和到知识库的链接
  2. 精炼
    Trim to focus on practical training implications.✓ 已复制
    → 精炼后的笔记

结果: 知识库新增一条深度工作的起点性条目。

注意事项
  • 引用可能未经完全核实 — 搭配 last30days-skill 或 arxiv-mcp-server 获取有来源支撑的真实引用
搭配使用: last30days-skill

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-obsidian-skill + obsidian-mcp-tools

用 MCP 访问知识库;用 skill 承载工作流

Use claude-obsidian /save with obsidian-mcp-tools as backend.✓ 已复制
claude-obsidian-skill + last30days-skill

让 /autoresearch 的来源保持最新且有据可查

When /autoresearch runs, fetch sources via last30days first.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
/wiki query 读取知识库 0
/save title?, scope? 有价值的对话后 0
/autoresearch topic, depth? 添加新的有来源条目 0

成本与限制

运行它的成本

API 配额
不适用
每次调用 Token 数
/wiki 较轻;/autoresearch 较重(5-20k)
费用
免费
提示
先用 /wiki 再用 /autoresearch——避免重复已有工作,节省 token

安全

权限、密钥、影响范围

最小权限: filesystem-read filesystem-write
凭据存储:
数据出站: 本地,除非 /autoresearch 需要获取外部来源

故障排查

常见错误与修复

/save 在知识库外创建了文件

设置 OBSIDIAN_VAULT 环境变量或显式传入 --vault

/wiki 返回空结果

检查知识库中是否有至少一条匹配的笔记;或重建 skill 的索引

反链无法解析

wiki 使用 [[标题]] 格式;确保文件名与标题完全一致

替代方案

Claude × Obsidian 对比其他方案

替代方案何时用它替代权衡
obsidian-mcp-tools(MCP)你需要基础构建块而非工作流MCP 更底层;此 skill 封装了主观的工作流决策
AgriciDaniel/wp-mcp-ultimate(不同领域)你用 WordPress 管理知识不同平台;同一作者

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills