scaled

Scaled MCP Server is a horizontally scalable MCP (Message Context Protocol) server implemented in Go. It is designed to be embedded in your application or run as a service to provide a transport-agnostic, actor-based MCP with support for static or dynamic tool registries, session management, and load-balanced operation across multiple instances. The server follows the MCP 2025-03 specification and focuses on flexibility, allowing you to swap out session stores (e.g., in-memory or Redis) and to register tools that can be invoked via the MCP protocol. Typical usage involves creating a server with a chosen configuration, registering tools (either statically or dynamically), and starting the HTTP transport layer if you want to expose MCP over HTTP, or integrating the MCP server with your own HTTP router if you’re using an external server.

You’ll find two main usage styles in the examples: (1) a Basic Server with a Static Tool where you build a simple calculator-style tool and register it with a static registry, and (2) an External HTTP Server example where you wire the MCP transport into your own HTTP router and start the MCP server alongside your custom routes. The library supports both static and dynamic tool registries, so you can either bake tools into the binary or provide tools at runtime via a provider. Tools define inputs like operation, a, and b, and return structured results, enabling clean separation between the MCP transport and the business logic implemented in your tools.

Prerequisites:

• Go 1.24 or higher installed on your system
• Git

Install steps:

1. Ensure Go is installed and workspace is set up
2. Retrieve the MCP server library:

go get github.com/traego/scaled-mcp@latest

3. Review the README examples to understand how to embed and configure the server in your application. If you plan to run a pre-built image, you can proceed with Docker as shown in the mcp_config example.

4. If you intend to build from source, clone the repository and run your build commands as you would for any Go project. For example:

git clone https://github.com/traego/scaled-mcp.git
cd scaled-mcp
# Build or run within your application as appropriate

5. Follow the “Usage” section in the README to integrate the server into your application and configure tools and sessions accordingly.

Notes and tips:

• The server supports both in-memory and Redis-backed session stores; choose cfg.Session.UseInMemory = true for simplicity or configure Redis for distributed sessions.
• You can use a static tool registry or a dynamic provider to supply tools at runtime.
• If you expose MCP over HTTP, the library includes a transport layer with a main /mcp endpoint and optional SSE endpoint, along with capabilities negotiation.
• When embedding in an external HTTP server, use the provided transport to connect your server’s actor system and session manager to your router.
• Ensure your Go version meets the minimum requirement (Go 1.24+ as noted in the README). If you run into compatibility issues, verify dependencies and module versions.
• If you use Docker, you can run a pre-built image as shown in the mcp_config section, but replace image-name with the actual image you intend to use. Check licensing and image source before deployment.