RBT MCP Server

MCP Server for editing RBT documents with partial operations. Reduces token consumption by 80-95% compared to full file read/write operations.

🎯 Key Features

Token Optimization: 80-95% reduction in LLM token usage
Structured Operations: Edit specific sections/blocks without loading entire documents
Smart Caching: LRU + TTL cache for frequently accessed documents
TASK Fuzzy Search: Find TASK files by index (e.g., "001" matches "TASK-001-PathResolver.md")
Template-based Creation: Auto-fill placeholders (project-id, feature-id, date)
13 MCP Tools: Complete CRUD operations for RBT documents

📦 Installation

Option 1: Install from source (uv)

# Clone repository git clone https://github.com/yourusername/KnowledgeSmith.git cd KnowledgeSmith # Install with uv uv pip install -e .

Option 2: Direct installation

uv pip install rbt-mcp-server

🚀 Quick Start

1. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "rbt-document-editor": { "type": "stdio", "command": "rbt-mcp-server", "env": { "RBT_ROOT_DIR": "/path/to/your/documents" } } } }

Or use full uv command:

{ "mcpServers": { "rbt-document-editor": { "type": "stdio", "command": "uv", "args": ["run", "rbt-mcp-server"], "env": { "RBT_ROOT_DIR": "/path/to/your/documents" } } } }

2. Set Environment Variable

export RBT_ROOT_DIR=/path/to/your/documents

3. Test the Server

rbt-mcp-server

📚 Available MCP Tools

get_outline - Get document structure (saves 80% tokens)
read_content - Read specific section/block (saves 90% tokens)
update_info - Update status/dependencies
update_section_summary - Update section summary
create_section - Create new sub-section
create_block - Create paragraph/code/list/table
update_block - Update block content
delete_block - Delete block
append_list_item - Add item to list
update_table_row - Update table row
append_table_row - Add table row
create_document - Create from template
clear_cache - Clear document cache

See rbt_mcp_server/README.md for detailed usage.

📊 Token Savings

Operation	Traditional	MCP	Savings
Read structure	4,000	800	80%
Update status	8,000	300	96%
Add list item	8,000	1,000	88%
Complete TASK	44,000	3,000	93%

🧪 Development

Install development dependencies:

uv sync --dev

Run tests:

RBT_ROOT_DIR=/test/root uv run pytest -v

Test coverage:

RBT_ROOT_DIR=/test/root uv run pytest --cov=rbt_mcp_server --cov-report=html

📝 License

MIT License

🤝 Contributing

Contributions welcome! Please open an issue or submit a pull request.

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

Enables efficient editing of RBT documents with structured operations that read and modify specific sections or blocks. Reduces LLM token consumption by 80-95% compared to full file operations through smart caching and partial document access.

Appeared in Searches

Context compression techniques and methods

RBT Document Editor