redmorestudio/thebrain-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP server for TheBrain API - enables AI assistants to interact with TheBrain knowledge management system with rich visual properties, attachments, and notes support
개요
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. 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. 1. : "Create a project with three phases" 2. what you want to accomplish 3. this into specific TheBrain API calls 4. creates the thoughts and connections 5. updates with the new structure The magic is that - just describe what you want in plain English!
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 MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"thebrain": {
"command": "node",
"args": ["/absolute/path/to/thebrain-mcp/index.js"],
"env": {
"THEBRAIN_API_KEY": "your_api_key_here"
}
}
}
}