basementstudio/xmcp

xmcp

Фреймворк TypeScript MCP

Создайте и поставьте MCP-серверы с уже известным кодом. Дайте ИИ-приложениям доступ к вашим инструментам, данным и рабочим процессам. Пишите функции TypeScript; xmcp отвечает за протокол, валидацию и транспортировку.

Начало

Создайте новое приложение xmcp:

Или добавить xmcp к существующему проекту:

Инструмент — это файл. Экспортируйте схему, метаданные и функцию, и xmcp регистрирует её:

Особенности

⊹ Маршрутизация файловой системы - Инструменты, запросы и ресурсы регистрируются автоматически из своих каталогов без конфигурации\ ⊹ Middlewares - Добавляйте аутентификацию, логирование, ограничения скорости или пользовательскую логику к каждому запросу\ ⊹ Transports - Отображать HTTP или STDIO из того же кода\ ⊹ Интеграции - Аутентификация с помощью Better Auth, Clerk, Auth0, WorkOS, Descope, Scalekit и Supabase; монетизация с помощью Polar, Commet и x402\ ⊹ Adapters - Запускаются внутри Next.js, Express, NestJS, Fastify, Hono, TanStack Start, Nuxt, SvelteKit, React Router или Astro\ ⊹ MCP Apps - Отправляйте интерактивные виджеты 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