mcp-builder-forge 0.2.1

The forge that builds MCP servers — Build, maintain and orchestrate MCP servers for Linux system administration

mcp-builder-forge

The father of MCP servers — Build, maintain and orchestrate MCP servers for Linux system administration.

What is this?

mcp-builder-forge is an MCP (Model Context Protocol) server that builds other MCP servers. It provides tools for:

• Project Scaffolding — Generate complete MCP server projects with FastMCP, Pydantic validation, tests, and Dockerfile
• Web Research — Extract documentation from URLs and convert OpenAPI specs to MCP servers
• Linux Command Discovery — Parse man pages and --help output to generate typed MCP tools
• Multi-Distribution Support — SUSE, RHEL, Debian/Ubuntu with auto-detection and adaptation
• Security Enforcement — Read-only/execute modes, shell injection prevention, supply chain verification
• Knowledge Base — Persistent learning about distributions, tools, errors, and solutions

Quick Start

# Run directly with uvx (no installation needed)
uvx mcp-builder-forge

# Or install and run
uv pip install mcp-builder-forge
mcp-builder-forge

Use with Kiro IDE

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

{
  "mcpServers": {
    "mcp-builder-forge": {
      "command": "uvx",
      "args": ["mcp-builder-forge"]
    }
  }
}

Available Tools (18)

Category	Tools
Scaffolding	scaffold_project, add_tool_to_project
Web Research	fetch_documentation, convert_openapi_spec
Linux Discovery	discover_linux_command, generate_tools_from_command
Knowledge Base	query_knowledge_base, update_knowledge_base
Maintenance	update_mcp_server, check_api_changes
Supply Chain	validate_package, verify_package_hash
Troubleshooting	log_error, find_solution, get_diagnostics
User Profile	get_user_profile, update_user_profile
Distro Detection	detect_distribution

Architecture

3-layer architecture:

1. Kiro Power — Steering files and workflows in the IDE
2. MCP Father Builder (this package) — Executable MCP server with 18 tools
3. Generated Products — Specialized MCPs per distro + multi-linux orchestrator

Supported Distributions

• SUSE: SLES 15 SP5/SP6, OpenSUSE Leap 15.5/15.6, Tumbleweed
• RHEL: RHEL 8/9, Amazon Linux 2/2023, CentOS Stream 9, Fedora 39/40
• Debian: Debian 11/12, Ubuntu 22.04/24.04

Security Features

• Read-only mode by default (no state modifications without explicit execute mode)
• Shell metacharacter rejection on all inputs
• Supply chain: 48h minimum package age, N-1/N-2 version preference, SHA-256 verification
• Audit logging for all high-risk operations
• User confirmation required before destructive actions
• Dry-run mode for previewing changes

Requirements

• Python 3.11+
• uv package manager

License

MIT