🚀 克劳迪西亚 MCP 服务器
本项目可助力你通过强大的服务器设置，与 Obsidian 笔记库实现无缝交互。无论你是新手还是经验丰富的用户，依照后续步骤说明，都能轻松搭建服务器。
🚀 快速开始
先决条件
在安装服务器之前，请确保你的系统已安装以下内容：
- Python 3.9+
- Git
- Playwright（用于网页抓取功能）
安装步骤
- 通过 IDE 克隆仓库 在你的首选 IDE（例如 Visual Studio Code）中克隆仓库： 使用 Visual Studio Code：
- 打开 VS Code。
- 点击左侧活动栏中的 源代码控制 图标。
- 点击 克隆仓库。
- 输入仓库 URL：
https://github.com/Synaptic-Labs-AI/claudesidian.git。 - 选择一个本地目录来保存项目。
- 克隆完成后，在 VS Code 中打开项目文件夹。
- 配置
claude_desktop_config.json更新claude_desktop_config.json文件，输入正确的路径：
{
"mcpServers": {
"claudesidian": {
"command": "claudesidian",
"args": [
"YOUR_OBSIDIAN_VAULT_PATH"
]
}
}
}
- 将
YOUR_OBSIDIAN_VAULT_PATH替换为你的 Obsidian 笔记库的实际路径。
- 安装依赖项 在终端中运行以下两个命令：
pip install -e .
playwright install
- 运行服务器
claudesidian "YOUR_OBSIDIAN_VAULT_PATH"
- 将
YOUR_OBSIDIAN_VAULT_PATH替换为你的 Obsidian 笔记库的实际路径。
✨ 主要特性
- 推理工具：管理推理模式，引导复杂问题解决流程。
- CreateMemory 工具：在每次交互结束时存储重要信息作为记忆。
- FuzzySearch 工具：在笔记库中执行模糊搜索，快速找到相关笔记。
- ScrapeWebsite 工具：抓取授权网站内容并将其归档为笔记。
- CreateNote 工具：方便地创建新的笔记。
- EditNote 工具：允许编辑现有的笔记。
- MemoryRetrieval 工具：根据查询从笔记库中检索和综合记忆。
- 关系工具：管理不同笔记或实体之间的关系信息。
📚 详细文档
故障排除
遇到问题时：
- 确保在 IDE 的终端中打开正确的项目目录后再运行安装和运行命令。
- 检查你的笔记库路径是否正确且可访问。
- 确保 Python 已添加到系统 PATH 中。
- 尝试运行
claudesidian --version在终端中验证安装。 - 检查 Claude Desktop 的日志文件。你可以导航到日志目录：
C:/Users/。/AppData/Roaming/Claude/logs
贡献
我们欢迎社区的贡献！以下是你可以帮助的方式：
- QA 测试：帮助我们发现 bug 并提高服务器的稳定性。
- 增强功能：建议或实现新功能以扩展功能。
- 反馈：在 讨论区 中留下你的评论和建议，帮助指导未来的发展。