ForgeCraft

Provides production-grade engineering standards for AI coding assistants, with tailored blocks and quality gates.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jghiringhelli-forgecraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgecraft-mcp"
      ]
    }
  }
}

ForgeCraft is an MCP server that injects production-grade engineering standards into your AI coding assistant workflow. It analyzes your project, generates tailored instruction files, and enforces quality gates to help you build reliable AI-assisted development pipelines.

How to use

You will set up ForgeCraft to tailor your AI assistant instructions to your stack. Start by integrating ForgeCraft with Claude or any supported MCP client, then trigger a project setup to scan your codebase, detect your tech stack, and generate a customized forgecraft.yaml plus instruction files. These files codify SOLID principles, architectural patterns, testing pyramids, and domain-specific rules, so your AI assistant can operate with consistent engineering standards.

How to install

Prerequisites: you need Node.js and npm installed on your system. You also require access to Claude as your MCP client, or a compatible MCP client that supports standard MCP commands.

claude mcp add forgecraft -- npx -y forgecraft-mcp

Restart Claude Code to apply the new MCP server configuration.

npx -y forgecraft-mcp

If you prefer configuring manually, add the MCP server to Claude settings as shown below. Create or update the file at .claude/settings.json with the following structure.

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Additional setup notes

ForgeCraft is an MCP server that provides Claude with 14 specialized tools. Claude selects the appropriate tools automatically based on your project. If you already ran a setup, ForgeCraft’s merge functionality can integrate with existing configurations while preserving your custom sections.

Configuration overview

After you run setup_project, ForgeCraft creates a configuration file and wiring that enables continuous context persistence, drift detection, and compliance scoring. Your project will include artifacts like forgecraft.yaml, CLAUDE.md, session tracking, and pre-commit quality gates.

Available tools

setup_project

Analyze the project, classify the code, configure settings, and generate instruction files for all supported AI assistants.

refresh_project

Rescan the project after changes to detect new tags and update the configuration.

classify_project

Analyze code to suggest relevant tags based on detected domains and architectures.

scaffold_project

Generate a full project structure to align with the selected standards.

generate_instructions

Create instruction files for every supported AI assistant, tailored to your stack.

audit_project

Score compliance against defined standards (0-100) and publish a CI-friendly report.

review_project

Provide a structured review checklist to verify quality gates and architecture.

convert_existing

Plan a phased migration for legacy code to fit the ForgeCraft standards.

add_hook

Add quality-gate hooks to enforce standards before commits.

add_module

Scaffold a new feature module aligned with chosen patterns.

configure_mcp

Generate or adjust the Claude settings file to enable MCP integration.

get_nfr_template

Provide non-functional requirements templates for tech specs.

list_tags

Show all available domain tags that ForgeCraft supports.

list_hooks

Display quality-gate scripts, filterable by tag.