MCP-Forge logo

MCP-Forge

by KennyVaneetvelde

MCP-Forge is a scaffolding tool for quickly bootstrapping new MCP server projects. It generates a well-structured project with boilerplate code, example tools, resources, and testing utilities.

View on GitHub

Last updated: N/A

What is MCP-Forge?

MCP-Forge is a scaffolding tool designed to quickly bootstrap new MCP (Model Context Protocol) server projects. It automates the creation of a project structure, including boilerplate code, example tools, resources, and testing utilities, allowing developers to focus on implementing server-specific logic.

How to use MCP-Forge?

To use MCP-Forge, install it using uvx mcp-forge or pip install mcp-forge. Then, use the new command to create a new server project, such as uvx mcp-forge new my-awesome-server. Navigate to the created directory, set up the Python environment using uv venv and uv pip install -e ., and then run the server using either the SSE or stdio entry points.

Key features of MCP-Forge

  • Generates a complete Python project structure for an MCP server.

  • Includes separate server entry points for SSE and stdio transports.

  • Provides example HelloWorld tool and HelloWorld/UserProfile resources.

  • Sets up Pydantic models for clear input/output schemas.

  • Uses uv for dependency management and task running.

Use cases of MCP-Forge

  • Quickly setting up a new MCP server project.

  • Creating a standardized project structure for MCP servers.

  • Generating boilerplate code for common MCP server components.

  • Providing examples of tools and resources for MCP servers.

FAQ from MCP-Forge

What is MCP?

The Model Context Protocol (MCP) is a specification for enabling communication between language models and external tools/services.

How do I install MCP-Forge?

It's recommended to use uvx mcp-forge or you can install it globally or in a dedicated environment using pip install mcp-forge.

How do I create a new MCP server project?

Use the new command: uvx mcp-forge new my-awesome-server.

What are the available options for the new command?

You can use --description or -d to provide a custom project description and --python-version or -p to specify the minimum required Python version.

How do I run the generated server?

Navigate to the project directory, set up the environment with uv venv and uv pip install -e ., then run the server using uv run python -m my_awesome_server.server_sse or uv run python -m my_awesome_server.server_stdio.