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
1 maintainer
Metadata
1 maintainer
Release files for mcp-builder-forge 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_builder_forge-0.3.0.tar.gz | 167.6 kB | Without provenance | Details for mcp_builder_forge-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_builder_forge-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for mcp_builder_forge-0.3.0-py3-none-any.whl |
Total release size: 275.2 kB
Release files / mcp_builder_forge-0.3.0.tar.gz
| Download URL | mcp_builder_forge-0.3.0.tar.gz |
|---|---|
| Size | 167.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae9c8f830a6bf206fc297d49c580677f6e0c2e554df5f556470e2d070acd64cc
|
|
BLAKE2b-256 checksum How to use checksums |
5412181e5c9537e4a9c951f316b1327e558a1c67fadbca27c72383fe63406a14
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Release files / mcp_builder_forge-0.3.0-py3-none-any.whl
| Download URL | mcp_builder_forge-0.3.0-py3-none-any.whl |
|---|---|
| Size | 107.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cfa5ced71192ba200cf1052691f733813286903ebd4ba5235a215c668fd182a0
|
|
BLAKE2b-256 checksum How to use checksums |
109095b0aa7aebb8e47dbccf21d638af184deab4e190b692526d0b03ba815c6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Security for mcp-builder-forge 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
