Automated setup CLI for hive-mcp - a Clojure-based MCP server that supercharges Claude Code with persistent memory, project management, and swarm coordination.
# 1. Install CLI and MCP server
go install github.com/hive-agi/hive-mcp-cli/cmd/hive@latest
go install github.com/hive-agi/hive-mcp-cli/cmd/hive-setup-mcp@latest
# 2. Register MCP server with Claude
claude mcp add hive-setup --scope user -- hive-setup-mcpVerify installation:
hive detect # Check prerequisites
claude mcp list | grep hive-setup # Verify MCP registration# Check system prerequisites
hive detect
# Run full setup (interactive)
hive setup
# Diagnose issues
hive doctor
# Attempt automatic fixes
hive doctor --fixThe hive setup command automates the complete hive-mcp installation:
- Clone - Clones hive-mcp repository to
~/hive-mcp - Shell - Configures environment variables in your shell rc file
- Prerequisites - Installs platform-specific dependencies
- Dependencies - Downloads Clojure dependencies via
clojure -P - Doom Sync - Syncs Emacs packages (if using Doom Emacs)
- Chroma - Sets up Docker volume and starts ChromaDB for vector storage
- Ollama - Configures Ollama with embedding model
- Emacs Daemon - Starts Emacs in daemon mode
- MCP Registration - Registers hive-mcp server with Claude CLI
Once installed, hive-mcp adds 100+ MCP tools to Claude Code:
- Persistent Memory - Project-scoped notes, decisions, and conventions stored in ChromaDB
- Kanban Board - Task management with todo/doing/review/done states
- Git Integration - Magit-powered git operations
- CIDER REPL - Clojure evaluation via Emacs CIDER
- Swarm Coordination - Spawn and coordinate multiple Claude agents
- Knowledge Graph - Semantic relationships between memories
- Code Analysis - clj-kondo linting and scc metrics
| Tool | Minimum Version | Purpose |
|---|---|---|
| Go | 1.21+ | To install this CLI |
| Emacs | 28.1+ | IDE integration and MCP server host |
| Java | 17+ | Clojure runtime |
| Clojure CLI | 1.11.0+ | Run hive-mcp server |
| Babashka | 1.3.0+ | Fast Clojure scripting |
| Docker | 20.0+ | Run ChromaDB |
| Git | 2.0+ | Clone repositories |
| Claude CLI | 0.1.0+ | MCP server registration |
- Ollama - Local LLM for agent delegation
- Doom Emacs - Enhanced Emacs configuration (recommended)
Scans your system and reports:
- Platform and package manager
- Shell configuration files
- Installed tools and versions
- Running services (Emacs daemon, Chroma, Ollama)
- Environment variables
Runs the full installation sequence. Idempotent - safe to run multiple times. Skips steps that are already complete.
Health checks for your installation:
- Version verification
- Service health (Chroma, Ollama endpoints)
- Environment validation
- MCP registration status
- Integration tests
Use --fix to attempt automatic repairs.
The hive-setup-mcp binary exposes the CLI commands as MCP tools, making them callable by AI assistants like Claude.
claude mcp add hive-setup -- hive-setup-mcpCommands with McpMeta are exposed as AI-callable tools:
| Tool | Description |
|---|---|
hive_detect |
Detect installed components, prerequisites, and environment |
hive_setup |
Install and configure hive-mcp components |
hive_doctor |
Run health checks with optional --fix parameter |
The MCP server uses Bonzai with MCP extensions to automatically generate tool schemas from command metadata. Only commands tagged with Mcp: &bonzai.McpMeta{...} are exposed.
After setup, these are configured in your shell:
HIVE_MCP_DIR=~/hive-mcp
BB_MCP_DIR=~/hive-mcp
OPENROUTER_API_KEY=<your-key> # Optional, for cloud LLM delegationMIT