AI导哈

知识管理协议服务器

一个MCP服务器，使AI助手能够与TheBrain的知识管理系统交互，提供全面的API访问和自然语言交互能力。

  • by redmorestudio
  • JavaScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 redmorestudio/thebrain-mcp

使用说明

TheBrain MCP服务器

MCP（模型上下文协议）服务器，使AI助手能够与TheBrain的知识管理系统进行交互。该服务器提供对TheBrain的API的全面访问，专注于与TheBrain强大的知识管理功能进行自然语言交互。

🔧 什么是MCP服务器？

MCP（模型上下文协议） 是一个标准，允许像克劳德这样的人工智能助手连接到外部工具和服务。将其视为自然语言和软件API之间的翻译器。

工作原理：

You → Claude → MCP Server → TheBrain API → Your Brain
  1. 你说：“创建一个包含三个阶段的项目”
  2. 克劳德明白了 你想完成什么
  3. MCP服务器翻译 将其转换为特定的TheBrain API调用
  4. TheBrain API 创造思想和联系
  5. 你的大脑 使用新结构进行更新

神奇之处在于 你不需要知道任何技术细节 -用简单的英语描述你想要什么！

🚀 什么真正有效

✅ 核心功能（工作）

  • 内容管理：创建、更新、删除想法和笔记
  • 文件附件：将图像、PDF、文档上传到思考中
  • Web引用：带有自动标题提取功能的URL附件
  • 丰富的笔记：完全支持Markdown和嵌入式内容
  • 关系映射：将思想与有意义的关系联系起来
  • 搜索：在想法、笔记和附件中进行全文搜索
  • 大脑管理：在多个大脑之间无缝切换
  • 自然语言接口描述你想要什么，克劳德负责细节

❌ 当前问题和限制

🚨 主要视觉造型问题

最大的限制：尽管API成功响应，但可视化属性实际上并不适用。

  • ❌ 思想色彩：API接受颜色，但它们不会出现在TheBrain中
  • ❌ 链接颜色：类似问题-接受但不适用
  • ❌ 链节厚度：API报告成功，但厚度不变
  • ❌ 视觉格式：所有视觉样式功能目前都无法使用

🐛 其他已知问题

  • 间歇性连接问题：成功操作后出现“字段必填”错误
  • 长音符限制：降价内容过长（不超过10k个字符）的问题
  • 文件路径敏感性：需要绝对文件路径；相对路径可能会失败
  • 连接定时：MCP初始化竞争条件导致零星故障
  • 内存限制：大文件附件可能会导致超时
  • 搜索限制：复杂的查询有时会返回不完整的结果

📋 API依赖项和约束

  • 单用户操作：没有实时协作功能
  • 无批量操作：无法有效导入/导出大型数据集
  • 需要API连接：没有可用的脱机模式
  • TheBrain API限制：受现有API功能限制
  • 需要认证：必须具有有效的TheBrain API密钥

🛠 当前解决方案

在视觉样式固定之前，使用以下替代方案：

  • 区分表情符号: 🟢🟡🔴⚪🔵 而不是颜色
  • 描述性名称: "🔴 “紧急任务”而不是有色思维
  • 丰富的降价笔记：在笔记中使用格式进行视觉组织
  • 层次结构：组织依赖父母/子女关系

安装

  1. 克隆此存储库：
git clone https://github.com/redmorestudio/thebrain-mcp.git
cd thebrain-mcp
  1. 安装依赖项：
npm install
  1. 创建一个 .env 使用API密钥文件：
THEBRAIN_API_KEY=your_api_key_here
THEBRAIN_DEFAULT_BRAIN_ID=optional_default_brain_id

配置

适用于克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "thebrain": {
      "command": "node",
      "args": ["/absolute/path/to/thebrain-mcp/index.js"],
      "env": {
        "THEBRAIN_API_KEY": "your_api_key_here"
      }
    }
  }
}

⚠️ 重要：在配置和文件附件中使用绝对文件路径。

调试与故障排除

常见问题及解决方案

“必填字段”错误:

  • 重新启动克劳德桌面
  • 验证 .env 文件具有正确的API密钥
  • 始终先设置活跃大脑：“将我的活跃大脑设置为[姓名]”

文件上传失败:

  • 使用绝对文件路径： /Users/username/Documents/file.pdf
  • 检查文件权限和是否存在
  • 保持文件大小合理（<50MB）

长音符问题:

  • 将笔记保持在10000个字符以下
  • 将大量内容分解为多个想法
  • 对长篇文档使用附件

调试模式:

VERBOSE=true node index.js

可用工具（25+功能）

大脑管理

  • list_brains -列出所有可用的大脑
  • get_brain -获取大脑详细信息
  • set_active_brain -为手术设置活跃的大脑
  • get_brain_stats -获取全面的大脑统计数据

思维操作

  • create_thought -创造想法（视觉属性不起作用）
  • get_thought -检索思想细节
  • update_thought -更新思维属性
  • delete_thought -删除一个想法
  • search_thoughts -在大脑中搜索
  • get_thought_graph -思考所有的联系
  • get_types -列出所有思维类型
  • get_tags -列出所有标签

链接操作

  • create_link -在想法之间建立联系（样式不起作用）
  • update_link -修改链接属性
  • get_link -获取链接详细信息
  • delete_link -删除链接

附件操作

  • add_file_attachment -将文件/图像附加到想法中✅
  • add_url_attachment -附加web URL✅
  • get_attachment -获取附件元数据
  • get_attachment_content -下载附件内容
  • delete_attachment -删除附件
  • list_attachments -列出思想附件

注释操作

  • get_note -在markdown/html/text中检索笔记✅
  • create_or_update_note -创建或更新笔记✅
  • append_to_note -将内容添加到现有注释中✅

高级功能

  • get_modifications -查看大脑改造历史

使用示例（实际有效的方法）

项目组织机构

You: "Create a project called 'Kitchen Renovation'"
Claude: Creates central project thought

You: "Add phases for planning, demolition, and installation"  
Claude: Creates connected sub-thoughts for each phase

You: "Attach my contractor quotes to the planning phase"
Claude: Uploads files to the planning thought

You: "Add a detailed note about the timeline to the project"
Claude: Creates rich markdown note with your timeline

研究与知识管理

You: "Create a research topic about sustainable energy"
Claude: Sets up main research thought

You: "Add sub-topics for solar, wind, and hydro power"
Claude: Creates organized thought hierarchy

You: "Attach relevant papers and web articles"
Claude: Adds file and URL attachments

You: "Search for everything related to efficiency"
Claude: Finds all relevant thoughts and content

🔮 路线图和未来发展

即时优先级（v1.2.0）

  • 🚨 修复视觉样式：调查颜色/厚度不适用的原因
  • 🔧 连接稳定性：解决MCP计时/比赛条件问题
  • 📝 长笔记支持：更好地处理大量降价内容
  • 🛡️ 错误处理：更优雅的故障和恢复

未来的增强功能

  • 批量操作 对于大型组织
  • 增强的模板 用于常见工作流
  • 性能优化 对于复杂的大脑
  • 离线功能 和缓存

技术架构

是什么让这台服务器与众不同

  • 自然语言接口：不需要技术知识
  • 全面覆盖API：25多种工具，涵盖所有TheBrain操作
  • 稳健的错误处理：优雅的失败和清晰的错误信息
  • 模块化设计：干净、可维护的代码架构
  • 生产就绪：正确的记录、测试和文档

当前状态

  • 版本1.1.0（2025年6月）
  • 核心功能: ✅ 完成并工作
  • 视觉特性: ❌ 需要调查的主要问题
  • 稳定性: 🟡 通常稳定，但存在间歇性连接问题

贡献

欢迎投稿！特别需要帮助的领域：

  • 视觉造型调查：为什么颜色/厚度不适用？
  • 连接稳定性：调试MCP竞争条件
  • 性能优化：大脑处理能力强
  • 文档：更多使用示例和教程

请随时提交问题或拉取请求。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

支持

  • TheBrain API文档: https://api.bra.in
  • 问题和Bug报告: https://github.com/redmorestudio/thebrain-mcp/issues
  • 问题：打开GitHub讨论

⚠️ 当前建议：使用此服务器 内容管理和组织 通过自然语言交互。在视觉样式功能修复之前，不要依赖它们。核心功能是可靠的，对于通过对话管理TheBrain内容非常有用！

相关 MCP