{"id":41128452,"url":"https://github.com/hive-agi/hive-mcp","last_synced_at":"2026-04-30T04:02:19.846Z","repository":{"id":330177435,"uuid":"1121865181","full_name":"hive-agi/hive-mcp","owner":"hive-agi","description":"MCP server for hive-framework development. A memory and agentic coordination solution.","archived":false,"fork":false,"pushed_at":"2026-04-14T16:33:26.000Z","size":24564,"stargazers_count":25,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-14T17:29:52.733Z","etag":null,"topics":["ai","ai-agents","coordination","llms","memory"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hive-agi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-23T17:23:20.000Z","updated_at":"2026-04-13T00:42:40.000Z","dependencies_parsed_at":"2026-02-10T08:04:35.728Z","dependency_job_id":null,"html_url":"https://github.com/hive-agi/hive-mcp","commit_stats":null,"previous_names":["buddhilw/emacs-mcp","hive-agi/hive-mcp"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/hive-agi/hive-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hive-agi%2Fhive-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hive-agi%2Fhive-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hive-agi%2Fhive-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hive-agi%2Fhive-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hive-agi","download_url":"https://codeload.github.com/hive-agi/hive-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hive-agi%2Fhive-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32454170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","coordination","llms","memory"],"created_at":"2026-01-22T18:14:49.461Z","updated_at":"2026-04-30T04:02:19.840Z","avatar_url":"https://github.com/hive-agi.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hive-mcp\n\n**Your AI finally remembers.**\n\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)\n\n---\n\n## The Problem\n\nYou explain your codebase to Claude. Architecture, constraints, patterns. Then you hit the context limit. New session. **Claude forgets everything.**\n\n## The Solution\n\n```\nSession 1                         Session 2\n───────────────────────────────────────────────────\nYou: \"Our auth uses JWT...\"       You: /catchup\nClaude: *learns*                  Claude: \"I remember:\n         ↓                         - Auth uses JWT with refresh\n     /wrap                         - Convention: validate at boundaries\n         ↓                         What should we work on?\"\n    [Memory]  ────────────────►\n```\n\nPersistent, project-scoped memory with semantic search. Conventions, decisions, snippets — stored locally, never forgotten.\n\n---\n\n## What Sets hive-mcp Apart\n\n| Capability | hive-mcp | Typical MCP servers |\n|---|---|---|\n| **Knowledge Graph** | Structural edges - how knowledge relate? | Flat key-value or vector-only |\n| **Session Continuity** | `/wrap` crystallizes, `/catchup` reconstructs — zero-down re-explaining across sessions | Manual copy-paste or lost |\n| **Multi-Agent Coordination** | Lings (planners) + drones (executors) with file claims, hivemind shouts, and a continuous production belt | Single-agent only |\n| **Scoped Memory** | Hierarchical Context Retrieval (HCR) - project scoping - with TTL decay | Global namespace or none |\n| **Extension Architecture** | `requiring-resolve` stubs with noop fallbacks - plug your extensions and play | Monolithic |\n\n---\n\n## Quick Start\n\n### 1. Install\n\n**Option A: Automated with [hive-mcp-cli](https://github.com/hive-agi/hive-mcp-cli) (Recommended)**\n\n```bash\n# Requires Go 1.21+\ngo install github.com/hive-agi/hive-mcp-cli/cmd/hive@latest\ngo install github.com/hive-agi/hive-mcp-cli/cmd/hive-setup-mcp@latest\n\n# Register and let Claude guide setup\nclaude mcp add hive-setup --scope user -- hive-setup-mcp\nclaude\n# Ask: \"Help me setup hive-mcp\"\n```\n\n**Option B: Manual**\n\n```bash\nexport HIVE_MCP_DIR=\"$HOME/hive-mcp\"\nexport BB_MCP_DIR=\"$HOME/bb-mcp\"\n\ngit clone https://github.com/hive-agi/hive-mcp.git \"$HIVE_MCP_DIR\"\ngit clone https://github.com/hive-agi/bb-mcp.git \"$BB_MCP_DIR\"\n\nclaude mcp add hive --scope user -- \"$HIVE_MCP_DIR/start-bb-mcp.sh\"\n```\n\n### 2. Verify\n\n```bash\nclaude mcp list | grep -q \"hive\" \u0026\u0026 echo \"OK\" || echo \"FAILED\"\n```\n\n### 3. Optional: Semantic Search\n\n```bash\nollama pull nomic-embed-text      # Local embeddings\ndocker compose up -d              # Chroma vector DB\n```\n\n### Prerequisites\n\n| Requirement | Version | Install |\n|---|---|---|\n| Claude Code | Latest | [claude.ai/download](https://claude.ai/download) |\n| Babashka | 1.3+ | [babashka.org](https://babashka.org) |\n| Java | 17+ | `apt install openjdk-17-jdk` |\n\n**Optional**: \n- Emacs 28.1+ for swarm vterm UI and buffer integration. See [Emacs Configuration](https://github.com/hive-agi/hive-mcp/wiki/Emacs-Configuration). \n- Headless mode works without Emacs (but WIP for stability of headless - recommended to use Emacs as a dependency).\n\n---\n\n## 20 Consolidated Tools\n\n| Tool | Purpose |\n|---|---|\n| `memory` | Persistent entries with semantic search, TTL decay, scoping |\n| `kg` | Knowledge Graph — edges, subgraphs |\n| `agent` | Spawn/kill/dispatch lings and drones |\n| `wave` | Parallel drone dispatch with validation |\n| `hivemind` | Shout/ask coordination between agents |\n| `session` | Wrap, catchup, whoami, context store |\n| `workflow` | Forge belt, FSM-driven production cycles |\n| `kanban` | Task management with plan-to-kanban |\n| `magit` | Git operations — status, stage, commit, push |\n| `cider` | Clojure nREPL eval, doc, completions |\n| `preset` | Agent presets — list, search, generate headers |\n| `analysis` | Kondo lint, SCC metrics, complexity hotspots |\n| `lsp` | Code analysis — callers, calls, namespace graph |\n| `project` | Projectile — files, search, hierarchy scan |\n| `emacs` | Eval elisp, buffers, notifications |\n| `olympus` | Grid layout control for multi-agent UI |\n| `agora` | Multi-agent deliberation and debates |\n| `config` | Runtime configuration management |\n| `migration` | KG/memory backup, restore, backend switching |\n| `multi` | Meta-facade — batch operations |\n\nEach tool is a consolidated namespace with subcommands (e.g., `memory add`, `memory query`, `kg traverse`).\n\n---\n\n## Architecture\n\n```\nClaude ──MCP──► hive-mcp (Clojure)\n                    │\n                    ├── Memory (Chroma vectors + scoped entries)\n                    ├── Knowledge Graph (DataScript, Datalevin, or Datahike)\n                    ├── Swarm (lings + drones + hivemind)\n                    ├── Workflows for AIs (building blocks for repeatable behavior)\n                    └── Extension Registry (requiring-resolve stubs)\n                            │\n                            └──► [optional] your extensions (e.g., plug openclaw, langchain, whatever etc)\n```\n\n---\n\n## Extensibility\n\nhive-mcp uses a plugin architecture based on the **IAddon protocol** with automatic classpath discovery. Creating a new addon takes one command:\n\n```bash\nclojure -Sdeps '{:deps {io.github.hive-agi/hive-mcp {:git/tag \"vX.Y.Z\" :git/sha \"...\"}}}' \\\n  -Tnew create :template hive-agi/addon :name com.example/my-addon\n```\n\nThis generates a complete project with:\n- **IAddon protocol implementation** (defrecord with 8 lifecycle methods)\n- **META-INF classpath manifest** (auto-discovered at startup, zero core changes)\n- **Unit tests** (12 tests covering lifecycle, tools, health)\n- **REPL-ready** development setup\n\n### Addon Types\n\n| Type | Use case |\n|------|----------|\n| **Native** | Clojure code in the same JVM — direct function calls |\n| **MCP Bridge** | Proxy to external MCP servers via stdio/sse |\n| **External** | Non-MCP integrations (REST APIs, CLI tools) |\n\n### How It Works\n\nAddons are discovered via `META-INF/hive-addons/*.edn` manifest files on the classpath (same pattern as Java's `ServiceLoader`). Manifests declare dependencies, and addons are loaded in topological order. No changes to hive-mcp core code needed.\n\nSee the [Creating Addons](https://github.com/hive-agi/hive-mcp/wiki/Creating-Addons) wiki guide and [ADR-0007](https://github.com/hive-agi/hive-mcp/wiki/ADR-0007-hive-addons-architecture) for architecture details.\n\n---\n\n## Carto Store (Cartography Snippets)\n\nCartography snippets (code-chunked embeddings for `carto_callers` / `carto_definition` / `carto_callees`) live in a dedicated vector store — separate from the general `:memory-store` — so recall tuning stays independent.\n\nDefault config (already wired in `docker-compose.yml` as service `qdrant-carto`):\n\n```clojure\n{:services\n {:qdrant-carto {:mode :local\n                 :host \"localhost\"\n                 :port 6333\n                 :collection \"carto-snippets\"\n                 :embedding {:provider :ollama\n                             :model \"nomic-embed-code\"}}\n  :carto-store  {:backend :qdrant-carto}}}\n```\n\n**User override example** (`~/.config/hive-mcp/config.edn`):\n\n```clojure\n{:services\n {:qdrant-carto {:host \"qdrant.internal\"\n                 :port 6333\n                 :collection \"my-carto\"\n                 :embedding {:provider :ollama\n                             :model \"nomic-embed-code\"}}\n  :carto-store  {:backend :qdrant-carto}}}\n```\n\nIf `:carto-store` is omitted, `hive-mcp.config.resolve/resolve-carto-store` logs a warning and falls back to `:memory-store` — the system keeps booting, but cartography writes land in the shared store. Production deployments should declare `:carto-store` explicitly.\n\nBring up the dedicated instance:\n\n```bash\ndocker compose up -d qdrant-carto\n```\n\n---\n\n## For LLMs\n\nSee [`CLAUDE.md`](CLAUDE.md) for project conventions, tool patterns, and memory usage guidelines.\n\n## Documentation\n\n| Resource | Description |\n|---|---|\n| **[Wiki](https://github.com/hive-agi/hive-mcp/wiki)** | Complete guides |\n| [Installation](https://github.com/hive-agi/hive-mcp/wiki/Installation) | Detailed setup |\n| [Troubleshooting](https://github.com/hive-agi/hive-mcp/wiki/Troubleshooting) | Common issues |\n\n---\n\n## Related\n\n| Repository | Description |\n|---|---|\n| **[bb-mcp](https://github.com/hive-agi/bb-mcp)** | Lightweight Babashka MCP wrapper (~50MB RAM) |\n| **[lsp-mcp](https://github.com/hive-agi/lsp-mcp)** | Clojure-LSP bridge addon (analysis, callers, references) |\n| **[basic-tools-mcp](https://github.com/hive-agi/basic-tools-mcp)** | File read/write/glob/grep tools addon |\n| **[hive-dsl](https://github.com/hive-agi/hive-dsl)** | DSL verb compiler for batch operations |\n| **[hive-test](https://github.com/hive-agi/hive-test)** | Test utilities for hive-mcp addons |\n| **[olympus-web-ui](https://github.com/hive-agi/olympus-web-ui)** | Web dashboard for swarm monitoring |\n| **[hive-mcp-cli](https://github.com/hive-agi/hive-mcp-cli)** | Go CLI for automated setup |\n\n---\n\n[AGPL-3.0-or-later](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhive-agi%2Fhive-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhive-agi%2Fhive-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhive-agi%2Fhive-mcp/lists"}