A utility module for creating Express applications with Model Context Protocol (MCP) support.
npm install mcp-create-express-app expressimport express from "express";
import createExpressApp from "mcp-create-express-app";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
// Create an MCP server
const server = new McpServer({
name: "my-server",
version: "1.0.0",
});
// Define tools, prompts, and resources
server.tool("greet", { name: "string" }, async ({ name }) => {
return { content: [{ type: "text", text: `Hello, ${name}!` }] };
});
const app = await createExpressApp(server);
// Start the Express server
const port = 3000;
app.listen(port, () => {
console.log(`MCP server available at http://localhost:${port}${mcpPath}`);
});import express from "express";
import { createStateful } from "mcp-client-router/create-express-app";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
// Create an Express app
const app = express();
// Create an MCP server
const server = new McpServer({
name: "my-server",
version: "1.0.0",
});
// Define tools, prompts, and resources
server.tool("greet", { name: "string" }, async ({ name }) => {
return { content: [{ type: "text", text: `Hello, ${name}!` }] };
});
// Mount the MCP server to the Express app with stateful behavior
const mcpPath = "/mcp";
createStateful(app, server, {
path: mcpPath,
sessionTimeout: 300000, // 5 minutes
});
// Start the Express server
const port = 3000;
app.listen(port, () => {
console.log(
`Stateful MCP server available at http://localhost:${port}${mcpPath}`
);
});function createStateless(app, server, options)Creates a stateless HTTP endpoint for an MCP server in an Express app. Each request is treated as independent.
app(Express app): The Express applicationserver(McpServer): The MCP server to exposeoptions(object): Configuration optionspath(string): The URL path to mount the MCP server (default: '/mcp')corsOptions(object): CORS configuration options
function createStateful(app, server, options)Creates a stateful HTTP endpoint for an MCP server in an Express app. Maintains session state between requests.
app(Express app): The Express applicationserver(McpServer): The MCP server to exposeoptions(object): Configuration optionspath(string): The URL path to mount the MCP server (default: '/mcp')sessionTimeout(number): Session timeout in milliseconds (default: 30 minutes)corsOptions(object): CORS configuration options
ISC