TheBrain API的MCP服务器 - 允许AI助手与具有丰富的视觉属性,附件和注释支持的TheBrain知识管理系统互动
概览
一个MCP(模式上下文协议)服务器,使AI助手能够与TheBrain的知识管理系统互动. 这个服务器提供了对TheBrain的API的全面访问,专注于与TheBrain强大的知识管理能力的自然语言互动. 是一种让克劳德等AI助手与外部工具和服务连接的标准. 把它看作是自然语言和软件API之间的翻译. 1.:"以三个阶段创造出一个项目" 2. 您想要完成什么 3. 这一点被具体到 TheBrain API调用 4. 创建想法和连接 5. 更新与新结构 魔术就是 用简单的英语来形容你想要的!
概述（AI 翻译）
一个MCP(模式上下文协议)服务器,使AI助手能够与TheBrain的知识管理系统互动. 这个服务器提供了对TheBrain的API的全面访问,专注于与TheBrain强大的知识管理能力的自然语言互动.
# # # 什么是MCP服务器?
**MCP(模式上下文协议)**是允许克洛德等AI助手连接到外部工具与服务的标准. 把它看作是自然语言和软件API之间的翻译.
如何运作:
1.** 你说**:“创建一个有三个阶段的项目”. 2. ** 克劳德理解你想要达到的目标。 3. ** MCP 服务器将** 翻译为特定的 TheBrain API 调用 4. ** 大脑 API** 创造思想和联系 5. ** 你的大脑** 新结构的最新情况
魔术是,你不需要知道任何技术细节——用简单的英语描述你想要的东西!
#######什么实际可行
- 核心功能(工作)**
- ** 应急管理**: 创建、更新、删除想法和注释
- 文件附件: 上传图像、 PDF 文档到思维
- Web 参考:带有自动标题提取的URL附件
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
TheBrain MCP Server
An MCP (Model Context Protocol) server that enables AI assistants to interact with TheBrain’s knowledge management system. This server provides comprehensive access to TheBrain’s API, focusing on natural language interaction with TheBrain’s powerful knowledge management capabilities.
🔧 What’s an MCP Server?
MCP (Model Context Protocol) is a standard that lets AI assistants like Claude connect to external tools and services. Think of it as a translator between natural language and software APIs.
How It Works:
You → Claude → MCP Server → TheBrain API → Your Brain
- You say: “Create a project with three phases”
- Claude understands what you want to accomplish
- MCP Server translates this into specific TheBrain API calls
- TheBrain API creates the thoughts and connections
- Your Brain updates with the new structure
The magic is that you don’t need to know any technical details - just describe what you want in plain English!
🚀 What Actually Works
✅ Core Functionality (Working)
- Content Management: Create, update, delete thoughts and notes
- File Attachments: Upload images, PDFs, documents to thoughts
- Web References: URL attachments with auto-title extraction
- Rich Notes: Full Markdown support with embedded content
- Relationship Mapping: Connect thoughts with meaningful relationships
- Search: Full-text search across thoughts, notes, and attachments
- Brain Management: Switch between multiple brains seamlessly
- Natural Language Interface: Describe what you want, Claude handles the details
❌ Current Issues & Limitations
🚨 Major Visual Styling Problems
The biggest limitation: Visual properties don’t actually apply despite API success responses.
- ❌ Thought colors: API accepts colors but they don’t appear in TheBrain
- ❌ Link colors: Similar issue - accepted but not applied
- ❌ Link thickness: API reports success but thickness doesn’t change
- ❌ Visual formatting: All visual styling features are currently non-functional
🐛 Other Known Issues
- Intermittent connection problems: “Field required” errors after successful operations
- Long notes limitations: Issues with very long markdown content (keep under 10k characters)
- File path sensitivity: Requires absolute file paths; relative paths can fail
- Connection timing: MCP initialization race condition causing sporadic failures
- Memory constraints: Large file attachments can cause timeouts
- Search limitations: Complex queries sometimes return incomplete results
📋 API Dependencies & Constraints
- Single-user operations: No real-time collaboration features
- No bulk operations: Can’t import/export large datasets efficiently
- API connectivity required: No offline mode available
- TheBrain API limitations: Bound by existing API capabilities
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"thebrain": {
"command": "node",
"args": ["/absolute/path/to/thebrain-mcp/index.js"],
"env": {
"THEBRAIN_API_KEY": "your_api_key_here"
}
}
}
}