Xsmcp

🚀 xsMCP

xsMCP 是一款小型 MCP SDK，可用于快速构建客户端或服务器。它不强制使用特定服务器或模式库，十分轻便。

🚀 快速开始

xsMCP 是用于快速构建客户端/服务器的小型 MCP SDK。

✨ 主要特性

• 不强制使用特定服务器或模式库，体积轻便。
• 基于 Web 标准，不依赖任何服务器框架，可独立使用或与其他框架结合。
• 仅返回 JSON 响应，不支持 SSE（Server-Sent Events）。

📚 详细文档

项目简介

🚧 重要提示

此项目正在积极开发中，请保持关注！

为什么创建此项目？

@modelcontextprotocol/sdk体积庞大，并且依赖于像 zod、express 等库，这些库可能你根本不需要使用。与 xsAI 一样，xsMCP 并不强制你使用特定的服务器或模式库，并且非常轻便。

开发路线图

我们当前的目标是支持流式 HTTP 客户端/服务器功能，而对 Stdio 的支持优先级较低。

兼容性

xsMCP v0.1 针对 2025-03-26 版本 进行了定制，并不向后兼容。

HTTP 服务器结构

@xsmcp/server-http 基于 Web 标准，而不是 Express。

💻 使用示例

基础用法

import { createServerAdapter } from '@whatwg-node/server'
import { createHttpServer } from '@xsmcp/server-http'
import { createServer as createMcpServer } from '@xsmcp/server-shared'
import { createServer } from 'node:http'

import * as tools from '...'

const s = createMcpServer({ ...options })

for (const tool of tools) {
  s.addTool(tool)
}

const server = createHttpServer(s)

// (req: Request) => Promise<Response>
type ServerFetch = typeof server.fetch

// node.js
const httpServer = createServer(createServerAdapter(server.fetch))
httpServer.listen(3000)

// next.js
export const POST = router.fetch

// cloudflare workers, bun
export default server

高级用法

import { createHttpServer } from '@xsmcp/server-http'
import { createServer as createMcpServer } from '@xsmcp/server-shared'
import { Elysia } from 'elysia'
import { Hono } from 'hono'
import { AutoRouter } from 'itty-router'

import * as tools from '...'

const s = createMcpServer({ ...options })

for (const tool of tools) {
  s.addTool(tool)
}

const server = createHttpServer(s)

// hono
new Hono()
  .post('/mcp', ({ req }) => server.fetch(req.raw))

// elysia
new Elysia()
  .post('/mcp', ({ request }) => server.fetch(request))

// itty-router
AutoRouter()
  .post('/mcp', req => server.fetch(req))

此服务器既可以独立使用，也可以与 hono、elysia 和 itty-router 等框架结合使用以获取更多功能。同时，它不依赖任何服务器框架，因此体积非常小巧。出于简化考虑，此服务器仅返回 JSON 响应，而不支持 SSE（Server-Sent Events）。

📄 许可证

本项目使用 MIT 许可证。第三方项目的许可证信息如下：

• @whatwg-node/server
• hono.dev