Hive Mind

Provides real-time and retroactive documentation generation for codebases via the Hive Mind MCP Server.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jahanzaib-kaleem-hive-mind-mcp": {
      "command": "uvx",
      "args": [
        "mcp-hivemind-server"
      ]
    }
  }
}

Hive Mind MCP Server automatically builds living documentation for your codebase. It generates hivemind.md and flowchart.mmd at every directory level, enabling real-time documentation as you code and retroactive documentation for existing projects. It preserves user requirements and architectural decisions, supports AI navigation via anchor points, and works with varying context window sizes to keep your documentation in sync with your codebase.

How to use

You interact with the Hive Mind MCP Server through an MCP client to generate and navigate documentation. Start a local server and connect your client to begin real-time documentation while you work. You can also trigger a full codebase walk to generate documentation across the entire project, or engage in guided builds where you provide context and guidance as the documentation is created.

How to install

Prerequisites: Python 3.11 or higher. A MCP client or orchestration tool to load MCP servers is helpful, but you can also run the server directly if you follow the quick start.

Option A: Quick Start with uvx (no installation required) run the MCP server directly with the following configuration:

{
  "mcpServers": {
    "hive-mind": {
      "command": "uvx",
      "args": ["mcp-hivemind-server"]
    }
  }
}

Option B: Install via pip

Install the Hive Mind MCP Server package using pip, then run the server with your preferred method.

pip install mcp-hivemind-server

Option C: Install from source (development)

Clone the repository, set up a virtual environment, install dependencies, and run the server from source.

# Clone the repository
git clone https://github.com/Jahanzaib-Kaleem/hive-mind-mcp.git
cd hive-mind-mcp

# Create virtual environment
python -m venv venv
venv\Scripts\activate  # Windows
# source venv/bin/activate  # macOS/Linux

# Install dependencies
pip install -r requirements.txt

Prerequisites and environment

Ensure you have Python 3.11 or higher and the necessary Python dependencies installed, including mcp, tree-sitter, tree-sitter-languages, aiofiles, and pyyaml.

pip install mcp tree-sitter tree-sitter-languages aiofiles pyyaml

Available tools

document_current_work

Real-time documentation while building code

build_hive

Auto-document entire codebase (structure only)

navigate_to

Load context from anchor point

find_function

Search for function across codebase

trace_usage

Find dependencies and dependents

update_hivemind

Update docs when code changes

start_hive_build

Start guided build, returns first directory for YOU to document

continue_hive_build

Submit YOUR context, get next directory

get_hive_status

Check progress of guided build