Skip to main content
Glama
hephaestus-docker-power

hephaestus-docker-power

by alehayeb

Hephaestus Docker Power

A Kiro Power for setting up and managing Hephaestus using Docker containers.

Overview

This power provides MCP tools and steering guides for:

  • Setting up Hephaestus development environment

  • Managing Docker containers (Qdrant, MCP server)

  • Initializing databases

  • Troubleshooting common issues

  • Production deployment best practices

Related MCP server: MCP Development Environment

Installation

Option 1: Install via Kiro Powers Panel

  1. Open Kiro

  2. Go to Powers panel

  3. Add this repository URL

Option 2: Manual MCP Configuration

Add to your .kiro/settings/mcp.json:

{
  "mcpServers": {
    "hephaestus-setup": {
      "command": "python",
      "args": ["/path/to/hephaestus-docker-power/src/setup_server.py"],
      "env": {
        "HEPHAESTUS_ROOT": "/path/to/Hephaestus",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Available Tools

Tool

Description

check_prerequisites

Verify Python, tmux, git, docker, node, npm are installed

check_services

Check Docker daemon, Qdrant, MCP server status

start_qdrant

Start Qdrant vector database container

stop_qdrant

Stop Qdrant container (optionally remove volume)

init_databases

Initialize SQLite and Qdrant databases

validate_env

Check .env has required API keys

configure_project

Update hephaestus_config.yaml with project path

health_check

Comprehensive health check of all components

view_logs

View logs from server, monitor, or qdrant

clean_reset

Full reset (requires confirmation)

quick_setup

Complete setup in one command

Quick Start

# Complete setup in one command
quick_setup(project_path="/path/to/your/project")

Or step by step:

check_prerequisites()
validate_env()
start_qdrant()
init_databases()
configure_project("/path/to/project")
health_check()

Steering Files

  • steering/getting-started.md - Full setup walkthrough

  • steering/troubleshooting.md - Common issues and solutions

  • steering/production.md - Production deployment guide

Requirements

  • Python 3.10+

  • Docker

  • fastmcp (pip install fastmcp)

  • pyyaml (pip install pyyaml)

Environment Variables

  • HEPHAESTUS_ROOT - Path to Hephaestus installation (defaults to current directory)

  • FASTMCP_LOG_LEVEL - Log level for MCP server (default: ERROR)

License

MIT

Available Tools

7 tools
check_prerequisitesB

Check if all required tools are installed for running Hephaestus.

Inputs: no named parameters. Returns: object

check_servicesA

Check the status of Docker daemon, Qdrant, and MCP server.

Inputs: no named parameters. Returns: object

health_checkB

Perform comprehensive health check of all Hephaestus services.

Inputs: no named parameters. Returns: object

start_qdrantB

Start the Qdrant vector database container.

Inputs: no named parameters. Returns: object

stop_qdrantC

Stop the Qdrant container.

Inputs: remove_volume. Returns: object

validate_envA

Validate the .env file has required API keys configured.

Inputs: no named parameters. Returns: object

view_logsB

View recent logs from a Hephaestus service (qdrant, server, or monitor).

Inputs: service, lines. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation4/5

    Tools are mostly distinct but check_services and health_check overlap slightly; both check service status but health_check is more comprehensive.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case, e.g., check_prerequisites, start_qdrant, view_logs.

    Tool Count4/5

    7 tools is a reasonable number for managing Docker services, though adding start/stop for other services could be beneficial.

    Completeness3/5

    Covers prerequisites, service checks, Qdrant lifecycle, env validation, and logs but lacks start/stop for server/monitor and restart operations.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables remote Docker management over SSH via a local MCP server, providing tools to manage containers, images, Compose, and system resources.
      1
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a Docker-based development environment with Python and Node.js MCP servers, enabling file operations, SQL queries, Redis caching, and debugging for building and testing MCP servers.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables managing a local Minecraft hosting service through MCP, including server creation, start/stop, mod installation, and log retrieval.
      -