EXT-MCP
🧩 Extendable MCP Framework
ext-mcp introduces two core concepts: middleware and mods.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
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 還是本機指令? 兩種安裝方式的差異
┌─────────────────────────┐
│ 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]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Ext 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 Extendable MCP Framework