Obsidian-MCP-Server（注：这里的“Obsidian”可能指的是某种软件、服务器或特定项目名称，“MCP”通常指“Modding Client Protocol”或类似的缩写，但具体含义需根据上下文确定；“Server”即服务器）
将Claude从一个聊天工具转变为您的Obsidian知识库中的智能代理。
不要从Claude的成果中复制粘贴，而是利用智能模板、领域知识和自动化格式化功能，直接将结构化笔记写入您的知识系统。
为何这感觉如此有自主性
单独使用时，Claude 只能为你提供你复制粘贴的文物信息。单独使用时，MCP 服务器只能写入你明确指示它写入的文件。但当它们结合在一起时，就像在你的 Obsidian 密室中扮演了一个轻量级的“代理”角色：Claude 会检测你想要的笔记类型，应用合适的模板，添加标签/链接，然后 MCP 服务器直接将其写入你的密室。结果：结构化的笔记，无需复制粘贴，以及智能的建议，让 Claude 像一个密室原生的合作者一样。
快速入门
想在10分钟内试试吗？ → 快速入门指南
需要完整的设置吗？ → 继续阅读下文
______________________________________________________________________
概述
此模型上下文协议（MCP）服务器使Claude Desktop能够直接在您的Obsidian知识库中创建结构化的Markdown笔记。该系统由两个协同工作的组件组成：
- MCP 服务器 (此仓库) - 直接处理对您的Obsidian知识库的文件写入操作
- “Claude Project”翻译成中文是“克劳德项目” - 包含用于结构化内容生成的提示工程和模板
主要特点：
- 在Obsidian知识库中直接创建文件
- 结构化笔记模板（决策日志、书籍笔记、MOCs（管理变更控制或类似缩写，具体根据上下文确定）等）
- 消除复制粘贴的工作流程
- 通过环境变量配置保险库路径
- 专业的提示工程以确保格式一致
先决条件
安装前，请确保您已具备：
- Node.js (v16 或更高版本) - 在此下载
- Claude Desktop（可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”） - 在此下载
- 黑曜石 与现有的保险库一起 - 在此下载
完整安装指南
步骤1：安装MCP服务器
克隆仓库
git clone https://github.com/BrandonDFairbanks/obsidian-mcp-server.git
cd obsidian-mcp-server安装依赖项
npm install配置环境变量
创建一个 .env 项目目录中的文件：
cp .env.example .env编辑 .env 文件并更新保险库路径：
OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault查找您的保险库路径：
- 打开 Obsidian
- 右键点击任意笔记 → “在Finder中显示”（macOS）或“在文件夹中显示”（Windows）
- 复制文件夹路径直到您的保险库名称
配置Claude桌面版
创建或编辑Claude桌面配置文件：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%/Claude/claude_desktop_config.json
添加此配置：
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/full/path/to/obsidian-mcp-server/obsidian-mcp.js"]
}
}
}替换 /full/path/to/obsidian-mcp-server/ 替换为您克隆仓库的实际路径。
重启Claude桌面版
完全退出 Claude Desktop 并重新打开，以便配置生效。
步骤2：配置Claude项目
MCP服务器负责文件写入，但您需要一个Claude项目来生成结构化内容。
创建Claude项目
- 创建一个新的Claude项目 在Claude Desktop中
- 复制完整的说明 来自
claude-project-setup.md - 将内容粘贴到您项目的自定义说明中 田野；领域；场地
- 保存项目
“Claude项目提供的内容”
- 领域知识 关于知识管理的工作流程
- 模板逻辑 针对不同类型的笔记（决策日志、书籍笔记、管理评审会议记录、普通笔记）
- 输出检测 在人工制品和直接文件创建之间切换
- 质量标准 为了保持格式一致并提供有用的链接建议
见 claude-project-setup.md 对于完整的模板、域名映射以及详细的配置。
第三步：完成工作流程
启动MCP服务器
node obsidian-mcp.js服务器将持续运行。在使用Claude时，请保持此终端窗口打开。
使用集成功能
在您配置的Claude项目中，使用明确的命令来触发直接文件创建：
决策日志：
Use write_note to create a decision log about choosing our tech stack读书笔记：
Create a book note using write_note for 'Atomic Habits'MOCs（内容地图）：
Build an MOC using write_note for Financial Planning一般说明：
Use write_note to create a product management note about user story refinement预期结果
- 立即创建文件 在你的Obsidian知识库中
- 结构化格式化 带有适当的标签、链接和模板
- 确认信息 来自 Claude 的消息：“已创建笔记：\[文件名\] 在您的 Obsidian 知识库中”
- 无需复制粘贴 - 文件直接出现在您的知识系统中
使用示例
创建决策日志
命令： "Use write_note to create a decision log about whether to buy a camping trailer"
结果： 创建一个结构化的决策日志，其中包含：
- 多个选项的优缺点部分
- “Gut check and family input areas”可以翻译为“自我审视环节及家庭意见交流环节”。这里，“Gut check”指的是自我审视或内心检查的过程，而“family input areas”则指的是家庭成员参与意见交流或贡献的部分
- 3个月和6个月后的随访追踪
- 相关链接供探索
创建读书笔记
命令： "Create a book note using write_note for 'The Creature from Jekyll Island'"
结果： 创建一个包含以下内容的书籍笔记：
- 自动填充的作者（G. Edward Griffin）
- 适当类别（货币理论）
- 特定领域的标签（#金融）
- 为引用、见解和联系设置结构化板块
构建MOC（模型操作中心/制造运营中心等，具体含义根据上下文确定）
命令： "Build an MOC using write_note for Decision Making"
结果： 创建内容地图，其中包含：
- 为框架、方法、模板组织了相应部分
- 手动填写的空白占位符
- 知识组织的逻辑结构
故障排除
服务器无法启动
# Reinstall dependencies
rm -rf node_modules package-lock.json
npm install
# Test basic functionality
node -e "console.log('Node.js working')"克劳德看不见工具
- 验证
claude_desktop_config.json语法有效 - 确保文件路径是绝对路径，而非相对路径
- 完全重启Claude桌面应用（而不仅仅是关闭窗口）
- 在终端检查服务器是否正在运行
文件未显示在Obsidian中
- 验证保险库路径
.env是正确的 - 通过在该目录中手动创建文件进行测试
- 检查Obsidian知识库的权限
- 确保Obsidian指向的是同一个资料库位置
Claude项目无法运行
- 确认你已完整复制了说明
claude-project-setup.md - 确保您正在使用配置好的项目（而非通用的Claude聊天）
- 使用明确的“write_note”命令
- 检查MCP服务器和Claude项目是否都已正确配置
权限错误
macOS： 你可能需要授予终端对文件的访问权限 Windows： 如需，请以管理员身份运行终端
高级配置
自定义笔记模板
Claude项目模板可以根据您的特定需求进行修改：
- 编辑模板中的内容
claude-project-setup.md - 调整领域知识和标签映射
- 修改链接建议模式
- 更新Claude项目说明
添加新的笔记类型
添加新的结构化注释类型：
- 在Claude项目设置中创建模板
- 添加识别模式和生成逻辑
- 使用MCP集成进行测试
- 无需对MCP服务器代码进行更改
技术细节
MCP（模型上下文协议）： 使Claude能够安全地与外部工具和系统进行交互。
建筑： 通过stdio传输连接到Claude Desktop的Node.js服务器。该服务器提供了一个 write_note 处理文件操作的工具。
安全： 环境变量将个人密钥库路径与共享代码分开。仓库中不存储任何敏感信息。
发展
项目结构
obsidian-mcp-server/
├── obsidian-mcp.js # Main server code
├── package.json # Dependencies and metadata
├── .env # Your local configuration (not tracked)
├── .env.example # Template for environment variables
├── claude-project-setup.md # Complete Claude project instructions
├── QUICKSTART.md # 10-minute setup guide
└── README.md # This file扩展功能
服务器可以扩展以支持更多工具：
- 文件读取功能
- 笔记的查找与更新
- 自定义模板系统
- 与其他知识管理工具的集成
做出贡献
- 为仓库创建分支
- 创建一个特性分支
- 做出你的更改
- 对两个组件进行彻底测试
- 提交拉取请求
许可证
MIT 许可证 - 详情请参见 LICENSE 文件。
支持
对于问题或疑问：
- 查看上面的故障排除部分
- 试试这个 快速入门指南 为了简化设置
- 验证MCP服务器和Claude项目均已正确配置
- 在GitHub上创建一个问题，详细说明你的设置情况
- 确保您的环境满足前提条件
______________________________________________________________________
重要提示： 这个系统需要MCP服务器（用于文件写入）和Claude项目（用于内容生成）同时正常运行。在使用Claude时，服务器必须持续运行，并且需要明确的“write_note”命令来触发直接文件创建，而不是生成制品。