1.0.1 • Published 5 months ago

@myjungle/docu-mcp-manager v1.0.1

Weekly downloads
-
License
-
Repository
github
Last release
5 months ago

DocuMCP Manager

šŸ¤– An MCP supervisor server for coordinating documentation generation agents

DocuMCP Manager is a specialized MCP server designed to coordinate multiple Claude Code sub-agents that use the DocuMCP server for documentation generation. It provides tools for managing documentation workflows across large codebases using shared vector databases and semantic search.

✨ Features

  • šŸŽÆ Coordinate multiple documentation generation agents
  • šŸ” Semantic search across code, documentation, and diagrams
  • šŸ“ File operations and directory management
  • šŸ—ƒļø Shared vector database across all agents
  • šŸ’¾ Support for multiple vector databases (LanceDB, ChromaDB, Qdrant)
  • 🧠 Flexible embedding providers (built-in or Ollama)

šŸš€ Quick Start

Installation

The DocuMCP Manager server is designed to work alongside the main DocuMCP server. First ensure you have the DocuMCP server set up, then add the Manager server.

Add the following to your Claude Desktop configuration:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "docu-mcp-manager": {
      "command": "node",
      "env": {
        "VECTOR_DB_PROVIDER": "lance",
        "LANCE_PATH": "~/shared-lanceDB",
        "EMBEDDING_PROVIDER": "buildin"
      },
      "args": ["/absolute/path/to/DocuMCP/manager/dist/index.js"]
    }
  }
}

Important: Ensure the Manager server uses the same vector database configuration as your DocuMCP sub-agents to enable shared access.

šŸš€ Manual Setup

1. Build the Manager Server

From the DocuMCP monorepo root:

cd manager
npm install
npm run build

2. Configure Shared Vector Database

For agent coordination, all agents must share the same vector database:

Example with Qdrant (Production):

{
  "mcpServers": {
    "docu-mcp-manager": {
      "command": "node",
      "env": {
        "VECTOR_DB_PROVIDER": "qdrant",
        "QDRANT_URL": "http://localhost:6333",
        "EMBEDDING_PROVIDER": "ollama",
        "EMBEDDING_MODEL": "bge-m3:latest",
        "EMBEDDING_DIMENSION": "1024",
        "OLLAMA_URL": "http://localhost:11434"
      },
      "args": ["/absolute/path/to/DocuMCP/manager/dist/index.js"]
    }
  }
}

3. Start Required Services (if using external providers)

For Qdrant:

cd qdrant
npm run start

For ChromaDB:

cd chromadb
npm run start

4. Restart Claude Desktop

Restart Claude Desktop to load the new configuration.

šŸ› ļø Configuration Options

Vector Database Providers

ProviderDescriptionConfiguration
LanceDBFile-based local database (default)VECTOR_DB_PROVIDER=lanceLANCE_PATH=~/lanceDB
ChromaDBSimple vector database with web UIVECTOR_DB_PROVIDER=chromaCHROMA_URL=http://localhost:8000
QdrantProduction-grade vector databaseVECTOR_DB_PROVIDER=qdrantQDRANT_URL=http://localhost:6333

Embedding Providers

ProviderDescriptionConfiguration
Built-inUses all-MiniLM-L6-v2 model (default)EMBEDDING_PROVIDER=buildinEMBEDDING_MODEL=all-MiniLM-L6-v2EMBEDDING_DIMENSION=384
OllamaUse any Ollama modelEMBEDDING_PROVIDER=ollamaEMBEDDING_MODEL=bge-m3:latestEMBEDDING_DIMENSION=1024OLLAMA_URL=http://localhost:11434

šŸ”§ Available Tools

The Manager server provides these tools for coordinating documentation workflows:

  • šŸ“ File Operations: read_file, write_file, create_directory, read_directory
  • šŸ”Ž Search Tools: search_codebase, search_documentation, search_diagram, search_user_guide
  • šŸ—ƒļø Indexing: index_file, index_directory
  • šŸ—‘ļø Management: remove_index_collection

Note: The manager server currently shares the same tool set as DocuMCP. Future versions will add agent coordination tools.

šŸŽÆ Agent Coordination Strategy

The Manager server is designed to coordinate multiple sub-agents:

  1. Shared Database: All agents use the same vector database instance
  2. Task Distribution: Manager assigns documentation tasks to sub-agents
  3. Result Aggregation: Sub-agent outputs are collected in the shared database
  4. Workflow Orchestration: Complex documentation generation across large codebases

Future Enhancements

  • Process spawning and management tools
  • Task queue implementation
  • Inter-agent communication protocols
  • Workflow templates for common documentation patterns
  • Progress monitoring and reporting

šŸ“‹ Requirements

  • Node.js 20.11.24+
  • Claude Desktop
  • DocuMCP server (for sub-agents)
  • (Optional) Docker for running external vector databases

šŸ¤ Contributing

Contributions are welcome! Please feel free to submit a Pull Request.


Made with ā¤ļø