Xsmcp

🚀 xsMCP

小型のMCP SDKで、クライアント/サーバーを迅速に構築できます。

🚀 クイックスタート

xsMCPは、クライアント/サーバーを迅速に構築するための小型のMCP SDKです。以下に、このプロジェクトの概要や特徴を紹介します。

✨ 主な機能

なぜこのプロジェクトを作成したのか？

@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

⚠️ 重要提示

このプロジェクトは現在積極的に開発中です。引き続きご注目ください！