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:
- Kiro Power — Steering files and workflows in the IDE
- MCP Father Builder (this package) — Executable MCP server with 18 tools
- 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
executemode) - 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mcp_builder_forge-0.3.0.tar.gz
(167.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_builder_forge-0.3.0.tar.gz.
File metadata
- Download URL: mcp_builder_forge-0.3.0.tar.gz
- Upload date:
- Size: 167.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae9c8f830a6bf206fc297d49c580677f6e0c2e554df5f556470e2d070acd64cc
|
|
| MD5 |
658724496cbcdf2b0c5dcea80c5f189b
|
|
| BLAKE2b-256 |
5412181e5c9537e4a9c951f316b1327e558a1c67fadbca27c72383fe63406a14
|
File details
Details for the file mcp_builder_forge-0.3.0-py3-none-any.whl.
File metadata
- Download URL: mcp_builder_forge-0.3.0-py3-none-any.whl
- Upload date:
- Size: 107.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cfa5ced71192ba200cf1052691f733813286903ebd4ba5235a215c668fd182a0
|
|
| MD5 |
937193e043a5019dbcd2d815adb36a5a
|
|
| BLAKE2b-256 |
109095b0aa7aebb8e47dbccf21d638af184deab4e190b692526d0b03ba815c6e
|