MCP Forge

🚀 MCP-Forge

MCP-Forge is a scaffolding tool for quickly setting up new MCP (Model Context Protocol) server projects. It generates a well-structured project with sample tools, resources, and testing utilities, allowing you to focus on building the server's functionality.

🚀 Quick Start

MCP-Forge is a scaffolding tool that enables you to rapidly set up new MCP (Model Context Protocol) server projects. It creates a well - structured project, including sample tools, resources, and testing utilities, so you can concentrate on developing the server's functionality.

⚠️ Important Note

This is an early version of MCP - Forge. The API, generated structure, and features may change as the MCP ecosystem evolves. Feedback and contributions are welcome!

🌟 Support Development

If you find this project useful, please consider supporting its development through donations:

Your support will help maintain and improve this project!

✨ Features

• Generate a complete Python project structure for MCP servers.
• Provide a unified server entry point and select SSE and stdio transport modes via the --mode parameter.
• Include sample tools (AddNumbers, DateDifference, etc.) and resources (HelloWorld, UserProfile).
• Use Pydantic models to define clear input/output architectures.
• Use uv for dependency management and task running.

📦 Installation

It is recommended to use uvx (from uv), which handles temporary environments:

# Ensure uv is installed
uvx mcp-forge --help

Alternatively, you can install it globally or use pip in a dedicated environment:

pip install mcp-forge
mcp-forge --help

💻 Usage Examples

Basic Usage

Create a New Project

To create a new MCP server project, run the following command:

mcp-forge new my-awesome-server
cd my-awesome-server

Start the Server

To start the server, execute the following command:

uv run python -m my_awesome_server.server --mode=sse

Or, if you have entered the project directory:

my-awesome-server --mode=sse  # Run in SSE mode (HTTP service on 0.0.0.0:6969)
my-awesome-server --mode=stdio # Run in stdio mode

Advanced Usage

Project Structure

The generated project structure is as follows:

my_awesome_server/
├── server.py             # Main server file
├── tools/               # Custom tools directory
│   └── __init__.py      # Tools initialization file
├── resources/           # Resources directory
│   └── __init__.py      # Resources initialization file
└── requirements.txt     # Project dependency management file

📚 Documentation

The Model Context Protocol (MCP) is a specification for implementing communication between language models (or other clients) and external tools/services (servers). It defines how servers expose tools and resources in a standard way.

For more information, visit MCP official documentation.

🤝 Contribution

Contributions to MCP - Forge are welcome! This is an early project with plenty of room for improvement and new features.

1. Fork the repository (mcp-forge).
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing features').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is open - source under the MIT license. For detailed information, please check the generated LICENSE file or the source repository.