xsMCP

extra-small MCP SDK for mcp builders hating bloat.

About

🚧 This project is under active development, stay tuned!

Why is there this project?

@modelcontextprotocol/sdk is large and has dependencies on libraries like zod, express, etc. that you probably don't even want to use.

Like xsAI, xsMCP does not force you to use a particular server or schema library and is very small.

Roadmap

Our current target is Streamable HTTP Client / Server, Stdio have lower priority.

Compatibility

xsMCP v0.1 is targeted to be compatible with the 2025-03-26 revision and is not backward compatible.

HTTP Server Structure

@xsmcp/server-http is based on Web Standards, not Express.

import { createFetch } from '@xsmcp/server-http'
import { createServer } from '@xsmcp/server-shared'
import { serve } from 'srvx'

import * as tools from '...'

const server = createServer({ ...options })

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

// (req: Request) => Promise<Response>
const fetch = createFetch(server)

// node.js, deno, bun
serve({ fetch })

// cloudflare workers, pages
export default { fetch }

It can be used as a server on its own or with hono, elysia and itty-router for more features:

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

import * as tools from '...'

const server = createServer({ ...options })

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

const fetch = createFetch(server)

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

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

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

At the same time, it does not depends on any server framework thus minimizing the size.

For simplicity reasons, this server only returns JSON Response, not SSE.

License

MIT

Third Party Licenses

This project partially copies code from the following projects: