x-mcp

Overview

ext-mcp is a structured framework for building MCP servers with a clear separation of concerns. It introduces two core concepts: middleware for shared capabilities with an onion-style execution model, and mods as collections of MCP features like tools, prompts, and resources. The framework allows developers to organize their MCP implementations through modular components, making it easier to manage complex functionality. The architecture supports function-based, file path, and npm package installations for both middleware and mods, providing flexibility in how developers extend their servers.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• say-helloname: string

  Used for MCP mod demo

  Try:Say hello to JohnTry:Greet Alice with a hello message

Comparable tools

Installation

# Installation
npm i ext-mcp

# Basic usage
import path from "path";
import XMCP from "ext-mcp";

const app = new XMCP({
  name: "my-mcp",
  version: "0.0.1"
});

# Add middleware
app.use(path.join(__dirname, "./middlewares/logger"));
app.use(errorHandler);

# Install mods
app.installMod(path.join(__dirname, "./mods/say-hello"));
app.installMod(sayGoodbye);

# Start the service
app.start();

{
  "mcpServers": {
    "ext-mcp": {
      "command": "node",
      "args": ["path/to/your/script.js"]
    }
  }
}

FAQ

How is ext-mcp different from other MCP implementations?

ext-mcp introduces a middleware and mod architecture that allows for better organization of MCP features, enabling reusable middleware components and modular feature development.

Can I use existing MCP tools with ext-mcp?

Yes, ext-mcp is designed to work with standard MCP tools. You can create tools following the MCP protocol and integrate them into the mod system.

Compare x-mcp with