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