克劳迪西亚 MCP 服务器

简介

欢迎来到 Claudesidian MCP Server！这个项目让你可以通过一个强大的服务器设置无缝地与 Obsidian 笔记库交互。无论你是新手还是有经验的用户，按照以下步骤说明即可轻松搭建服务器。

先决条件

在安装服务器之前，请确保你的系统已安装以下内容：

• Python 3.9+
• Git
• Playwright（用于网页抓取功能）

安装步骤

1. 通过 IDE 克隆仓库

   在你的首选 IDE（例如 Visual Studio Code）中克隆仓库：

   使用 Visual Studio Code：

   • 打开 VS Code。
   • 点击左侧活动栏中的 源代码控制 图标。
   • 点击 克隆仓库。
   • 输入仓库 URL：https://github.com/Synaptic-Labs-AI/claudesidian.git。
   • 选择一个本地目录来保存项目。
   • 克隆完成后，在 VS Code 中打开项目文件夹。

2. 配置 claude_desktop_config.json

   更新 claude_desktop_config.json 文件，输入正确的路径：

   {
     "mcpServers": {
       "claudesidian": {
         "command": "claudesidian",
         "args": [
           "YOUR_OBSIDIAN_VAULT_PATH"
         ]
       }
     }
   }
   

   • 将 YOUR_OBSIDIAN_VAULT_PATH 替换为你的 Obsidian 笔记库的实际路径。

3. 安装依赖项

   在终端中运行以下两个命令：

   pip install -e .
   

   playwright install
   

4. 运行服务器

   claudesidian "YOUR_OBSIDIAN_VAULT_PATH"
   

   • 将 YOUR_OBSIDIAN_VAULT_PATH 替换为你的 Obsidian 笔记库的实际路径。

可用工具

• 推理工具：管理推理模式，引导复杂问题解决流程。
• CreateMemory 工具：在每次交互结束时存储重要信息作为记忆。
• FuzzySearch 工具：在笔记库中执行模糊搜索，快速找到相关笔记。
• ScrapeWebsite 工具：抓取授权网站内容并将其归档为笔记。
• CreateNote 工具：方便地创建新的笔记。
• EditNote 工具：允许编辑现有的笔记。
• MemoryRetrieval 工具：根据查询从笔记库中检索和综合记忆。
• 关系工具：管理不同笔记或实体之间的关系信息。

故障排除

遇到问题时：

1. 确保在 IDE 的终端中打开正确的项目目录后再运行安装和运行命令。
2. 检查你的笔记库路径是否正确且可访问。
3. 确保 Python 已添加到系统 PATH 中。
4. 尝试运行 claudesidian --version 在终端中验证安装。
5. 检查 Claude Desktop 的日志文件。你可以导航到日志目录：C:/Users/<YourUsername>/AppData/Roaming/Claude/logs。

贡献

我们欢迎社区的贡献！以下是你可以帮助的方式：

• QA 测试：帮助我们发现 bug 并提高服务器的稳定性。
• 增强功能：建议或实现新功能以扩展功能。
• 反馈：在 讨论区 中留下你的评论和建议，帮助指导未来的发展。