basementstudio/xmcp

XMCP

TypeScript MCPフレームワーク

既に知っているコードでMCPサーバーを構築し、出荷しましょう。AIアプリケーションにツール、データ、ワークフローへのアクセスを与えます。TypeScript関数を書きます。xmcpがプロトコル、検証、トランスポートを担当します。

始める

新しいxmcpアプリを作成する:

または既存のプロジェクトにxmcpを追加することもできます:

ツールとはファイルです。スキーマ、メタデータ、関数をエクスポートすると、xmcpが登録します:

特徴

⊹ ファイルシステムのルーティング - ツール、プロンプト、リソースが設定なしでディレクトリから自動的に登録されます
⊹ ミドルウェア - すべてのリクエストに認証、ログ記録、レート制限、またはカスタムロジックを追加する
⊹ トランスポート - 同じコードからHTTPまたはSTDIO経由で提供する ⊹ *統合 - Better Auth、Clerk、Auth0、WorkOS、Descope、Scalekit、Supabaseによる認証;Polar、Commet、x402\での収益化 ⊹ アダプター - Next.js、Express、NestJS、Fastify、Hono、TanStack Start、Nuxt、SvelteKit、React Router、またはAstro内で動作 ⊹ MCPアプリ - ツールと一緒にインタラクティブなReactウィジェットを出荷する ⊹ どこでもデプロイ - Vercel、Cloudflare、Alpic、Replit、Railway、Render、または任意のNode.jsホスト\

The TypeScript MCP framework

Build and ship MCP servers with the code you already know. Give AI applications access to your tools, data, and workflows. Write TypeScript functions; xmcp handles the protocol, validation, and transport.

Getting started

Create a new xmcp app:

npx create-xmcp-app@latest

Or add xmcp to an existing project:

npx init-xmcp@latest

A tool is a file. Export a schema, metadata, and a function, and xmcp registers it:

// src/tools/greet.ts
import { z } from "zod";
import { type InferSchema } from "xmcp";

export const schema = {
  name: z.string().describe("The name of the user to greet"),
};

export const metadata = {
  name: "greet",
  description: "Greet the user",
};

export default async function greet({ name }: InferSchema) {
  return `Hello, ${name}!`;
}

Features

⊹ File system routing - Tools, prompts, and resources register automatically from their directories, with zero configuration
⊹ Middlewares - Add authentication, logging, rate limits, or custom logic to every request
⊹ Transports - Serve over HTTP or STDIO from the same code
⊹ Integrations - Authentication with Better Auth, Clerk, Auth0, WorkOS, Descope, Scalekit and Supabase; monetization with Polar, Commet and x402
⊹ Adapters - Run inside Next.js, Express, NestJS, Fastify, Hono, TanStack Start, Nuxt, SvelteKit, React Router or Astro
⊹ MCP Apps - Ship interactive React widgets alongside your tools
⊹ Deploy anywhere - Vercel, Cloudflare, Alpic, Replit, Railway, Render, or any Node.js host
⊹ Hot reloading - Instant feedback while you develop

Learn more

⊹ Visit xmcp.dev to learn more about the project.
⊹ Read the documentation for guides and API reference.
⊹ Start from a template.

Security