Metadata-Version: 2.4
Name: mcp-builder-forge
Version: 0.3.0
Summary: The forge that builds MCP servers — Build, maintain and orchestrate MCP servers for Linux system administration
Project-URL: Homepage, https://github.com/jacs-factory/mcp-builder-forge
Project-URL: Repository, https://github.com/jacs-factory/mcp-builder-forge
Project-URL: Issues, https://github.com/jacs-factory/mcp-builder-forge/issues
Project-URL: Documentation, https://github.com/jacs-factory/mcp-builder-forge#readme
Author-email: JACS <jacs@mcp-factory.dev>
License-Expression: MIT
Keywords: automation,builder,fastmcp,linux,mcp,python,security,sysadmin,uv,uvx
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: System :: Systems Administration
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: fastmcp==2.8.0
Requires-Dist: httpx==0.28.1
Requires-Dist: mcp==1.9.3
Requires-Dist: playwright==1.52.0
Requires-Dist: pydantic==2.11.4
Provides-Extra: dev
Requires-Dist: hypothesis>=6.100.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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

```bash
# 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`:

```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](https://docs.astral.sh/uv/) package manager

## License

MIT
