basementstudio/xmcp

The TypeScript MCP framework

1,326

stars

1,986

commits

TypeScript

primary language

Sep 3, 2026

updated

xmcp.dev
framework
mcp
modelcontextprotocol
typescript

README

XMCP logo

xmcp

xmcp logo NPM version License

The TypeScript MCP Framework

xmcp is a framework for building and shipping MCP servers with TypeScript. Designed with DX in mind, it streamlines development and lowers the barrier to entry for anyone looking to create and deploy powerful tools on top of the Model Context Protocol ecosystem.

Getting Started

Bootstrap your first xmcp application with:

npx create-xmcp-app@latest

or initialize xmcp on an existing Next.js or Express project with:

npx init-xmcp@latest

Features

File System Routing - Tools and prompts are auto-registered from a tools and prompts directory
Hot Reloading - Instant development feedback
Middlewares - Toolkit for shipping authentication and custom middlewares
Extensible Configuration - Customizable configuration for your MCP server
Deploy Anywhere - Flexible deployment across any platform
Vercel Support - Zero-configuration deployment with Vercel

Learn more

⊹ Visit xmcp.dev to learn more about the project.
⊹ Visit xmcp.dev/docs to view the full documentation.

Security

If you believe you have found a security vulnerability, we encourage you to let us know right away.

We will investigate all legitimate reports and do our best to quickly fix the problem.

Please report any vulnerabilities in our open source repositories to security@xmcp.dev.

Contributors

(top 30 of 34)

valebearzotti

1,195 commits

matiasngf

290 commits

fveiraswww

176 commits

0xKoller

170 commits

basementstudio/xmcp

The TypeScript MCP framework

1,326

stars

1,986

commits

TypeScript

primary language

Sep 3, 2026

updated

xmcp.dev
framework
mcp
modelcontextprotocol
typescript

README

XMCP logo

xmcp

xmcp logo NPM version License

The TypeScript MCP Framework

xmcp is a framework for building and shipping MCP servers with TypeScript. Designed with DX in mind, it streamlines development and lowers the barrier to entry for anyone looking to create and deploy powerful tools on top of the Model Context Protocol ecosystem.

Getting Started

Bootstrap your first xmcp application with:

npx create-xmcp-app@latest

or initialize xmcp on an existing Next.js or Express project with:

npx init-xmcp@latest

Features

File System Routing - Tools and prompts are auto-registered from a tools and prompts directory
Hot Reloading - Instant development feedback
Middlewares - Toolkit for shipping authentication and custom middlewares
Extensible Configuration - Customizable configuration for your MCP server
Deploy Anywhere - Flexible deployment across any platform
Vercel Support - Zero-configuration deployment with Vercel

Learn more

⊹ Visit xmcp.dev to learn more about the project.
⊹ Visit xmcp.dev/docs to view the full documentation.

Security

If you believe you have found a security vulnerability, we encourage you to let us know right away.

We will investigate all legitimate reports and do our best to quickly fix the problem.

Please report any vulnerabilities in our open source repositories to security@xmcp.dev.

Contributors

(top 30 of 34)

valebearzotti

1,195 commits

matiasngf

290 commits

fveiraswww

176 commits

0xKoller

170 commits

Languages

TypeScript

73.9%

MDX

21.5%

JavaScript

2.2%

Shell

1.5%