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