mcp-factory 1.0.0

A lightweight factory framework for creating and managing MCP (Model Context Protocol) servers with simplified configuration and project building capabilities.

MCP Factory

A factory framework focused on MCP server creation and management

🎯 Overview

MCP Factory is a lightweight MCP (Model Context Protocol) server creation factory. It focuses on simplifying the building, configuration and management process of MCP servers, enabling developers to quickly create and deploy MCP servers.

🌟 Core Features

• 🏭 Server Factory - Quickly create and configure MCP server instances
• 📁 Project Building - Automatically generate complete MCP project structure
• 🔧 Configuration Management - Flexible YAML configuration system
• 🔗 Server Mounting - Support multi-server mounting and management
• 🛠️ CLI Tools - Simple and easy-to-use command line interface

🚀 Quick Start

Installation

pip install mcp-factory

Or using uv:

uv add mcp-factory

Basic Usage

1. Create project using factory

from mcp_factory import MCPFactory

# Create factory instance
factory = MCPFactory(workspace_root="./workspace")

# Build new MCP project
project_path = factory.build_project(
    "my-server", 
    {"server": {"description": "My first MCP server"}}
)

# Create server instance
server_id = factory.create_server(
    name="my-server",
    source=project_path
)

2. Directly create managed server

from mcp_factory import ManagedServer

# Create managed server
server = ManagedServer(
    name="example-server",
    instructions="This is an example server"
)

# Add tools
@server.tool()
def hello(name: str) -> str:
    """Greet the specified user"""
    return f"Hello, {name}!"

# Run server
server.run()

3. Using CLI tools

# Create new project
mcp-factory project create my-project

# Run server from configuration file
mcp-factory server run config.yaml

# Run with custom transport
mcp-factory server run config.yaml --transport http --host 0.0.0.0 --port 8080

📁 Project Structure

mcp-factory/
├── mcp_factory/           # Core modules
│   ├── factory.py         # Factory main class
│   ├── server.py          # Managed server
│   ├── config/            # Configuration management
│   ├── project/           # Project building
│   ├── mounting/          # Server mounting
│   └── cli.py             # Command line tools
├── examples/              # Usage examples
├── tests/                 # Test suite
└── docs/                  # Documentation

🛠️ Core Components

MCPFactory

Factory main class, responsible for creating and managing MCP servers:

factory = MCPFactory(workspace_root="./workspace")

# Build project
project_path = factory.build_project("server-name", config_dict)

# Create server
server_id = factory.create_server("server-name", source)

# Manage servers
servers = factory.list_servers()

ManagedServer

Managed server class, providing complete MCP server functionality:

server = ManagedServer(name="my-server")

# Add tools
@server.tool()
def my_tool(param: str) -> str:
    return f"Processing: {param}"

# Run server
server.run()

📚 Examples

Check the examples/ directory for more usage examples:

• Basic Server - Create simple MCP server
• Factory Complete Example - Complete workflow using factory
• Server Mounting - Multi-server mounting

🧪 Testing

# Run all tests
pytest

# Generate coverage report
pytest --cov=mcp_factory

# Type checking
mypy mcp_factory

# Code formatting
ruff format .
ruff check .

📖 Documentation

• Configuration Guide
• CLI Usage Guide
• Architecture Documentation

🤝 Contributing

Contributions are welcome! Please check our contribution guidelines.

📄 License

This project is licensed under the Apache-2.0 License - see the LICENSE file for details.

---

Note: This is the stable version of MCP Factory (v1.0.0), focusing on core factory functionality with full type safety and modern Python practices.