EXT-MCP
🧩 Extendable MCP Framework
ext-mcp introduces two core concepts: middleware and .
Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
claude mcp add ext-mcp -- npx -y ext-mcp@1.0.2Выполните в терминале.
{ "mcpServers": { "ext-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Запускmods ┌─────────────────────────┐
│ LLM Request │
└─────────────────────────┘
↓
╔═════════════╗
║ middleware1 ║
╚═════════════╝
↓
╔═════════════╗
║ middleware2 ║
╚═════════════╝
↓
╔═══════════════════════════╗
║ mods ║
║ ┌─────┐ ┌─────┐ ┌─────┐ ║
║ │mod1 │ │mod2 │ │mod3 │ ║
║ └─────┘ └─────┘ └─────┘ ║
╚═══════════════════════════╝
↓
╔═════════════╗
║ middleware2 ║
╚═════════════╝
↓
╔═════════════╗
║ middleware1 ║
╚═════════════╝
🌰 See the complete example in the demo directory
npm i ext-mcp
import path from "path";
import XMCP from "ext-mcp";
import errorHandler from "./middlewares/error-handler";
import sayGoodbye from "./mods/say-goodbye";
const app = new XMCP({
name: "my-mcp",
version: "0.0.1",
});
// 🖇️ Middleware
app.use(path.join(__dirname, "./middlewares/logger")); // file path
app.use(errorHandler); // function
app.use(require.resolve('@foo/mcp-middleware-logger')); // npm/workspace package
// 🧩 Mods
app.installMod(path.join(__dirname, "./mods/say-hello")); // file path
app.installMod(sayGoodbye); // function
app.installMod(require.resolve('@foo/mcp-mod-demo')); // npm/workspace package
// Start the service. Currently only stdio mode is supported
app.start();
Example: implement a logger middleware that injects
logIdandloggerinto the context
import { type Middleware } from "ext-mcp";
export interface LoggerContext {
logId: string;
logger: {
info: (message: string) => void;
error: (message: string) => void;
};
}
const middleware: Middleware<LoggerContext> = async (context, next) => {
context.logId = `foo-log-id`;
context.logger = createLogger(context.logId);
context.logger.info(`mcp started: ${context.actionName}`);
const res = await next();
context.logger.info(`mcp finished: ${context.actionName}`);
return res;
};
export default middleware;
import type { Mod, Tool } from "ext-mcp";
import { z } from "zod/v3";
const sayHello: Tool<{ name: z.ZodString }> = {
name: "say-hello",
config: {
title: "Say hello",
description: "Used for MCP mod demo",
inputSchema: { name: z.string().describe("user's name") },
},
handler: (context) => {
const { name } = context.args;
return {
content: [
{
type: "text",
text: `Hello, ${name}!`,
},
],
};
},
};
const demoMod: Mod = {
name: "demo-mod",
version: "0.0.1",
description: "Demo mod",
tools: [sayHello],
};
export default demoMod;
# Install dependencies
npm install
# Build
npm run build
# Test
npm test
# Start the inspector. @see https://github.com/modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector
After the inspector starts, paste the absolute path to demo/run.sh into the Command field to begin debugging.
This repository includes configuration for several IDEs to view the demo directly:
{ "mcpServers": { "ext-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Ext работает локально через stdio.
Последняя проверка: 2026-11-16. Extendable MCP Framework