TheBrain MCP

探索

Thebrain MCP

#null .JavaScript

評分 : 2.5分

下載量 : 0

更新時間 : 2026-06-18

打開站點

安裝

複製以下命令到你的Client進行配置

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

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🧠 TheBrain MCP 服務器

一個 MCP (Model Context Protocol) 服務器，讓 AI 助手能夠與 TheBrain 知識管理系統交互。

本服務器提供對 TheBrain API 的全面訪問能力，專注於通過自然語言與 TheBrain 強大的知識管理功能進行交互。

🔧 什麼是 MCP 服務器？

MCP（Model Context Protocol，模型上下文協議） 是一種標準協議，讓 Claude 等 AI 助手能夠連接外部工具和服務。你可以把它想象成自然語言與軟件 API 之間的翻譯官。

⚙️ 工作原理

你 → Claude → MCP 服務器 → TheBrain API → 你的 Brain

你說："創建一個包含三個階段的項目"
Claude 理解你想達成的目標
MCP 服務器翻譯為具體的 TheBrain API 調用
TheBrain API 創建想法（thoughts）與連接
你的 Brain 更新為新的結構

神奇之處在於：你完全不需要了解任何技術細節——只需用大白話描述你想要什麼！

🚀 實際可用的功能

✅ 核心功能（已可用）

📝 內容管理：創建、更新、刪除想法和筆記
📎 文件附件：上傳圖片、PDF、文檔到想法節點
🌐 網頁引用：URL 附件並自動提取標題
📄 富文本筆記：完整的 Markdown 支持，可嵌入內容
🔗 關係映射：通過有意義的關係連接想法節點
🔍 搜索：跨想法、筆記和附件的全文搜索
🧠 Brain 管理：在多個 Brain 之間無縫切換
💬 自然語言接口：用自然語言描述需求，Claude 處理細節

❌ 當前問題與限制

🚨 重大視覺樣式問題

最大的限制：儘管 API 返回成功，但視覺屬性實際上並未生效。

❌ 想法顏色：API 接受顏色參數，但 TheBrain 中不顯示
❌ 鏈接顏色：同樣的問題——被接受但未應用
❌ 鏈接粗細：API 報告成功，但粗細不改變
❌ 視覺格式：當前所有視覺樣式功能均失效

🐛 其他已知問題

間歇性連接問題：操作成功後出現 "Field required" 錯誤
長筆記限制：超長 markdown 內容會出現問題（建議保持在 10k 字符以內）
文件路徑敏感：需要絕對路徑，相對路徑可能失敗
連接時序問題：MCP 初始化的競態條件導致偶發失敗
內存約束：大型文件附件可能導致超時
搜索限制：複雜查詢有時返回不完整的結果

📋 API 依賴與約束

單用戶操作：沒有即時協作功能
無批量操作：無法高效地導入/導出大數據集
需要 API 連接：無離線模式可用
TheBrain API 限制：受現有 API 能力約束
需要身份驗證：必須擁有有效的 TheBrain API 密鑰

🛠 當前變通方案

在視覺樣式修復之前，可以使用以下替代方案：

用 emoji 區分：使用 🟢🟡🔴⚪🔵 代替顏色
描述性名稱：使用 "🔴 緊急任務" 代替帶顏色的想法節點
富 Markdown 筆記：在筆記中使用格式進行視覺組織
層級結構：依賴父子關係進行組織

📦 安裝指南

克隆此倉庫：

git clone https://github.com/redmorestudio/thebrain-mcp.git
cd thebrain-mcp

安裝依賴：

npm install

創建包含 API 密鑰的 .env 文件：

THEBRAIN_API_KEY=your_api_key_here
THEBRAIN_DEFAULT_BRAIN_ID=optional_default_brain_id

⚙️ 配置

用於 Claude Desktop

將以下內容添加到你的 Claude Desktop 配置中：

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

⚠️ 重要提示

在配置和文件附件中務必使用絕對文件路徑。

🐞 調試與故障排除

常見問題與解決方案

"Field required" 錯誤：

重啟 Claude Desktop
檢查 .env 文件是否有正確的 API 密鑰
始終先設置活動 brain："把我的活動 brain 設置為 [名稱]"

文件上傳失敗：

使用絕對文件路徑：/Users/username/Documents/file.pdf
檢查文件權限和是否存在
保持文件大小合理（< 50MB）

長筆記問題：

筆記保持在 10,000 字符以內
將大內容拆分為多個想法節點
對於長的文檔使用附件

調試模式：

VERBOSE=true node index.js

🧰 可用工具（25+ 函數）

🧠 Brain 管理

list_brains - 列出所有可用的 brain
get_brain - 獲取 brain 詳情
set_active_brain - 設置用於操作的活動 brain
get_brain_stats - 獲取全面的 brain 統計數據

💭 想法操作

create_thought - 創建想法（視覺屬性不生效）
get_thought - 獲取想法詳情
update_thought - 更新想法屬性
delete_thought - 刪除想法
search_thoughts - 在 brain 中進行搜索
get_thought_graph - 獲取想法及其所有連接
get_types - 列出所有想法類型
get_tags - 列出所有標籤

🔗 鏈接操作

create_link - 在想法之間創建鏈接（樣式不生效）
update_link - 修改鏈接屬性
get_link - 獲取鏈接詳情
delete_link - 刪除鏈接

📎 附件操作

add_file_attachment - 附加文件/圖片到想法 ✅
add_url_attachment - 附加網頁 URL ✅
get_attachment - 獲取附件元數據
get_attachment_content - 下載附件內容
delete_attachment - 刪除附件
list_attachments - 列出想法的附件

📝 筆記操作

get_note - 以 markdown/html/text 格式獲取筆記 ✅
create_or_update_note - 創建或更新筆記 ✅
append_to_note - 向現有筆記追加內容 ✅

🚀 高級功能

get_modifications - 查看 brain 修改歷史

💻 使用示例（實際可用的功能）

🏗️ 項目組織

你："創建一個名為 '廚房翻新' 的項目"
Claude：創建中心項目想法節點

你："添加規劃、拆除和安裝等階段"
Claude：為每個階段創建相互連接的子想法節點

你："把我的承包商報價附到規劃階段"
Claude：上傳文件到規劃想法節點

你："給項目添加一條關於時間表的詳細筆記"
Claude：創建包含你時間表的富 Markdown 筆記

🔬 研究與知識管理

你："創建一個關於可持續能源的研究主題"
Claude：建立主要研究想法節點

你："添加太陽能、風能和水力發電等子主題"
Claude：創建有組織的想法層級

你："附加相關論文和網頁文章"
Claude：添加文件和 URL 附件

你："搜索所有與效率相關的內容"
Claude：找到所有相關的想法和內容

🔮 路線圖與未來開發

⚡ 近期優先事項 (v1.2.0)

🚨 修復視覺樣式：調查為什麼顏色/粗細不生效
🔧 連接穩定性：解決 MCP 時序/競態條件問題
📝 長筆記支持：更好地處理超長 markdown 內容
🛡️ 錯誤處理：更優雅的失敗與恢復機制

🚀 未來增強

批量操作 用於大規模組織
增強模板 用於常見工作流
性能優化 用於複雜 brain
離線能力 與緩存

🏛️ 技術架構

✨ 本服務器的特別之處

自然語言接口：無需技術知識
完整的 API 覆蓋：25+ 工具覆蓋所有 TheBrain 操作
健壯的錯誤處理：優雅的失敗與清晰的錯誤消息
模塊化設計：乾淨、可維護的代碼架構
生產就緒：完善的日誌、測試和文檔

📊 當前狀態

屬性	狀態
版本	1.1.0 (2025 年 6 月)
核心功能	✅ 完整可用
視覺屬性	❌ 存在重大問題，需調查
穩定性	🟡 總體穩定，但存在間歇性連接問題