@magic-ingredients/tiny-brain-local

Local MCP server implementation for Tiny Brain AI assistant with CLI installation tool.

Overview

This package serves dual purposes:

1. MCP Server: A local MCP (Model Context Protocol) server that runs on your machine using stdio transport
2. CLI Tool: A command-line tool to install the MCP server across different AI platforms

Installation

Option 1: NPM Global Installation (Recommended)

npm install -g @magic-ingredients/tiny-brain-local

Option 2: DXT Package Installation

For Claude Desktop users who prefer DXT packages:

1. Download the latest .dxt package from tiny-brain.com
2. Install using the DXT tool in Claude Desktop

Usage

As MCP Server

When run without arguments, tiny-brain operates as an MCP server:

tiny-brain

As CLI Installation Tool

The CLI provides commands to install, uninstall, and manage the MCP server across different AI platforms.

Install Command

Install tiny-brain on specific platforms or interactively:

# Interactive installation (recommended)
tiny-brain install

# Install on specific platform
tiny-brain install claude-code
tiny-brain install claude-desktop
tiny-brain install cursor
tiny-brain install chatgpt

# Install on all supported platforms
tiny-brain install --all

# Install with validation
tiny-brain install --validate

Uninstall Command

Remove tiny-brain from platforms:

# Interactive uninstallation
tiny-brain uninstall

# Uninstall from specific platform
tiny-brain uninstall claude-code

# Uninstall from all platforms
tiny-brain uninstall --all

# Skip confirmation prompt
tiny-brain uninstall --force

Status Command

Check installation status across platforms:

# Check all platforms
tiny-brain status

# Check specific platform
tiny-brain status --platform claude-code

# Show detailed information
tiny-brain status --verbose

List Command

List all supported platforms:

# List supported platforms
tiny-brain list

# Show which platforms are detected on system
tiny-brain list --detected

Supported Platforms

| Platform | Description | Config Location | |----------|-------------|-----------------| | Claude Code | Anthropic's AI coding assistant CLI tool | ~/.claude/code/config.json | | Claude Desktop | Desktop chat application for Claude AI | Platform-specific (see below) | | Cursor IDE | AI-powered code editor built on VSCode | ~/.cursor/config.json | | ChatGPT Desktop | OpenAI's desktop chat application | Platform-specific |

Platform-Specific Config Locations

Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Features

MCP Server Features

• Personas: Context-aware AI personalities with memory
• Rules System: Universal directives that apply across all personas
• Planning: Collaborative task management and tracking
• Thinking: Structured reasoning chains with consistency checking
• Strategies: Content generation strategies for different scenarios
• Updates: Automatic version checking and update notifications

CLI Features

• Interactive Mode: User-friendly prompts for platform selection
• Multi-Platform Support: Install on multiple platforms simultaneously
• Validation: Test server startup during installation
• Bundled Runtime Detection: Automatically uses bundled Node.js from AI platforms
• Progress Indicators: Visual feedback with emojis during operations
• Backup & Restore: Automatic config backup before modifications

Storage

All Tiny Brain data is stored locally. See Storage Paths Documentation for detailed information about data storage locations and configuration.

Manual Configuration

If you prefer to configure manually or the CLI doesn't work for your setup:

Claude Desktop

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "tiny-brain": {
      "command": "npx",
      "args": ["@magic-ingredients/tiny-brain-local"]
    }
  }
}

Claude Code

Add to ~/.claude/code/config.json:

{
  "servers": {
    "tiny-brain": {
      "command": "npx",
      "args": ["@magic-ingredients/tiny-brain-local"]
    }
  }
}

Troubleshooting

Common Issues

Installation fails with "command not found"

• Ensure Node.js 18+ is installed: node --version
• If using NPM, ensure global packages are in PATH
• Try using npx directly: npx @magic-ingredients/tiny-brain-local install

"Platform not detected" error

• The CLI couldn't find the AI application
• Check if the application is installed in the standard location
• Use manual configuration as a fallback

Permission denied errors

• On macOS/Linux, you may need to use sudo for global installation
• Alternatively, use npx to run without installing: npx @magic-ingredients/tiny-brain-local

Server validation fails

• Ensure no other process is using the required ports
• Check firewall settings aren't blocking the application
• Try installing without validation: remove --validate flag

Config file not found

• Some platforms may not create config files until first launch
• Launch the AI application once before running the installer
• Create the config directory manually if needed

Debug Mode

For troubleshooting, you can run with debug output:

DEBUG=tiny-brain* tiny-brain install

Development

# Install dependencies
npm install

# Build both server and CLI
npm run build

# Run tests
npm test

# Development mode (watches for changes)
npm run dev

# Test CLI locally
npm run build && node dist/cli.js install

Dependencies

• @magic-ingredients/tiny-brain-core: Core business logic
• @modelcontextprotocol/sdk: MCP protocol implementation
• commander: CLI framework
• inquirer: Interactive command line prompts
• chalk: Terminal string styling
• zod: Schema validation

License

MIT

Links

• GitHub Repository
• Core Package
• NPM Package
• DXT Registry
• Documentation

Support

For issues, questions, or contributions:

• GitHub Issues
• Discussions