eMCP

eMCP

这是 LiteMCP TS 库的分支，扩展了内置身份验证处理和自定义中间件等功能。

功能

本项目旨在成为 LiteMCP 等工具的近乎即插即用的替代品。因此，目前所有新增功能都是可选的。

• LiteMCP 的所有现有功能
• 内置身份验证处理程序
• 支持自定义分层中间件

快速入门

通过 Bun 或 NPM 安装：

npm i emcp
# or use Bun (preferred)
bun add emcp

基本用法

（可选）运行示例：

bun run example:basic
bun run example:auth
bun run example:middleware
bun run example:advanced

const server = new eMCP("mcp-server-with-auth", "1.0.0", {
  authenticationHandler: async (request) => {
    // implement your custom auth logic here
    return true;
  },
});

// Request to this tool, or any other resource or prompt will
// require authentication governed by the handler
server.addTool({
  name: "add",
  description: "Add two numbers",
  parameters: z.object({
    a: z.number(),
    b: z.number(),
  }),
  execute: async (args) => {
    server.logger.debug("Adding two numbers", args);
    return args.a + args.b;
  },
});

自定义中间件

const server = new eMCP("mcp-server-with-middleware", "1.0.0", {
  authenticationHandler: async (request) => {
    // implement your custom auth logic here
    return true;
  },
});

// This will time entire req -> res cycle, including middlewares
server.use(async (request, next) => {
  const startTime = Date.now();
  server.logger.debug("Request started", { method: request.method });

  // Wait for all inner middleware and the handler to complete
  const response = await next();

  const endTime = Date.now();
  server.logger.debug("Request completed", {
    method: request.method,
    duration: `${endTime - startTime}ms`,
  });

  return response;
});

中间件的工作方式

eMCP 中的中间件按注册顺序运行。所有中间件处理程序都执行到 next() 代码块后，才会执行标准 MCP 流程。服务器处理完毕后，对于 next() 代码块之后还有代码的中间件处理程序，将按相反顺序执行。

简单来说，它的运行方式大致如下：

<---- Request received ----
1. Middleware 1
2. Middleware 2
<---- Pre-processing done ---->
4. Server handler
<---- Post-processing start ---->
5. Middleware 2
6. Middleware 1
---- Response sent ---->

如果你熟悉 Hono 之类的框架，那么这套机制对你来说应该很熟悉。

路线图

• 便捷的 MCP<->MCP 通信
• 集成到框架中

为什么？

因为我想这么做