obsidian-helperlisted

# Obsidian Helper - 智能笔记助手 这是一个与 Obsidian MCP 深度整合的智能助手，提供三大核心功能来提升你的笔记效率。 --- ## ⚡ 首次使用必读：自动检测与配置引导 ### 执行任何功能前，Claude 必须先执行 STEP 0 ``` STEP 0: MCP 连接检测（每次会话首次使用时执行） ├─ 尝试调用 obsidian_list_files_in_vault() ├─ 如果成功 → 继续执行用户请求的功能 └─ 如果失败 → 进入【配置引导流程】 ``` ### 配置引导流程（全中文提示） 当 MCP 连接失败时，Claude 必须向用户显示以下引导信息： --- **检测到 Obsidian MCP 未连接，我来帮你配置！** #### 📋 配置步骤 **第一步：安装 Obsidian 插件** 1. 打开 Obsidian → 设置 → 第三方插件 2. 关闭「安全模式」 3. 点击「浏览」，搜索 **Local REST API** 4. 安装并启用该插件 **第二步：获取 API Key** 1. 在 Obsidian 设置中找到 **Local REST API** 插件设置 2. 点击「Copy API Key」复制你的 API Key 3. 记下端口号（默认是 `27124`） **第三步：配置 Claude Code MCP** 在终端运行以下命令，将 `你的API_KEY` 替换为刚才复制的 Key： ```bash # 创建 MCP 配置目录（如果不存在） mkdir -p ~/.claude # 添加 Obsidian MCP 配置 cat >> ~/.claude/mcp.json << 'EOF' { "mcpServers": { "mcp-obsidian": { "command": "npx", "args": ["-y", "mcp-obsidian"], "env": { "OBSIDIAN_API_KEY": "你的API_KEY", "OBSIDIAN_HOST": "https://127.0.0.1:27124" } } } } EOF ``` **或者手动编辑** `~/.claude/mcp.json`： ```json { "mcpServers": { "mcp-obsidian": { "command": "npx", "args": ["-y", "mcp-obsidian"], "env": { "OBSIDIAN_API_KEY": "你的API_KEY", "OBSIDIAN_HOST": "https://127.0.0.1:27124" } } } } ``` **第四步：重启 Claude Code** ```bash # 完全退出 Claude Code，然后重新启动 claude ``` **第五步：验证连接** 重启后，再次输入你想要的命令（如 `/daily`），我会自动验证连接是否成功。 --- #### ❓ 常见问题 | 问题 | 解决方案 | |------|----------| | 插件找不到 | 确保 Obsidian 版本 ≥ 1.0.0 | | 连