Mcp Forge

What is Mcp Forge?

Mcp Forge (MCP-Forge) is a framework for dynamically generating, managing, and monitoring Model Context Protocol (MCP) servers using the official MCP SDK. It enables you to create specialized MCP servers on demand through a centralized interface, with built-in templating, lifecycle management, auto-scaling, and enterprise-grade security.

How to use Mcp Forge?

Clone the repository, create a Python virtual environment, and install dependencies from requirements.txt. Start the forge server with python forge_mcp_server.py --port 9000, then use python client.py to create, list, start/stop/restart servers, and access logs, stats, or connect to specific servers. For example: python client.py create name="my-server" capabilities=["echo","time"].

Key features of Mcp Forge

• Dynamic server generation from templates with specific capabilities
• Flexible templating with custom handlers and server options
• Server lifecycle management (start, stop, restart, monitor)
• Built-in customizations: authentication, persistence, HTTP, database access
• Advanced monitoring of resources, logs, and performance metrics
• Auto-scaling based on demand and resource usage
• Centralized logging with filtering and searching
• Real-time status reporting and alerting system
• Comprehensive client API for managing the server ecosystem
• Enterprise-grade security: input validation, XSS/CSRF protection, rate limiting, DDoS protection

Use cases of Mcp Forge

• Creating specialized MCP servers on demand (e.g., echo, time, file reader, HTTP request handlers)
• Managing a fleet of MCP servers from a single control point with start/stop/restart commands
• Scaling groups of servers automatically based on CPU, memory, or request load
• Monitoring server health, aggregating logs, and receiving alerts for critical issues

FAQ from Mcp Forge

What are the runtime requirements to run Mcp Forge?

Python 3.7+ along with specific dependencies: MCP SDK 1.6.0+, httpx 0.28.0+, anyio 4.0.0+, psutil 5.9.0+, requests 2.31.0+, python-dateutil 2.8.2+, aiosmtplib 2.0.1+ (for email notifications), and optional prometheus-client 0.17.1+ and jsonschema 4.17.3+.

How do I create a server with custom handlers?

Use the client create command with the handlers parameter: python client.py create name="advanced-server" handlers=["file_reader","http_request"]. You can also specify server options like options={"persistence":"sqlite","auth":"basic"}.

What security protection mechanisms are included?

Mcp Forge implements input validation, XSS protection (Content Security Policy), CSRF token-based protection, SQL injection pattern validation, IP-based and global rate limiting, DDoS burst detection and blacklisting, security headers, server hardening, data encryption, intrusion detection, audit logging, and role-based authentication.

How can I access logs from multiple servers?

Use the client with the get_logs command: python client.py call get_logs source="system" log_level="error" limit=50 or python client.py call get_logs source="server-id" limit=100. Logs are aggregated centrally with filtering and searching.

Is the development of Mcp Forge complete?

Yes, the README states development is 100% complete with all 40 planned tasks implemented, including the comprehensive security protection mechanisms.