Simply MCP

The fastest way to build MCP servers. Tell an AI what you need, or write it yourself.

Tier 1 Compatible Framework

Simply-MCP is a Tier 1 Compatible Community Framework, providing 100% coverage of the Model Context Protocol specification (2025-11-25) and all active Standards Track SEPs.

• SEP-1865 (MCP Apps): Native support for rich, interactive UIs.
• SEP-1036 (URL Elicitation): Secure out-of-band user interaction.
• SEP-1577 (Sampling): Advanced LLM sampling with tool-use and context support.
• SEP-2339 (Tasks): Durable, asynchronous background operations.

View the full Compliance Report.

What You Can Build

Two Ways to Build

Path 1: Let AI Build It (Recommended)

With Claude Code or any AI coding tool:

> Build me an MCP server that monitors system resources
  and shows a real-time dashboard

The AI uses Simply-MCP's factory API to generate a complete, production-ready server. Iterate by describing what you want to change.

Path 2: Write It Yourself

import { createServer, createTool } from 'simply-mcp';

export const server = createServer({
  name: 'my-server',
  version: '1.0.0',
});

export const addTool = createTool({
  description: 'Add two numbers',
  params: {
    a: { type: 'number', description: 'First number' },
    b: { type: 'number', description: 'Second number' },
  },
  handler: ({ a, b }) => ({ sum: a + b }),
});

npx simplymcp run server.ts            # Run (stdio for Claude)
npx simplymcp run server.ts --port 3000  # Run (HTTP)

Both paths produce the same thing: a type-safe MCP server with tools, resources, and optional UI.

Install

npm install simply-mcp

The bare install pulls only the core MCP runtime (SDK, zod, yargs, MCP Apps). Opt-in features are declared as optional peer dependencies — install only the ones your server uses:

Missing-peer errors point at the exact package to install.

One Codebase. Multiple Platforms.

Write once. The OpenAI adapter is built-in.

Features

Why Simply-MCP?

// The old way: schema, types, validation, handler — all separate
const schema = { name: 'add', inputSchema: { type: 'object', properties: { a: { type: 'number' } } } };
interface AddParams { a: number; b: number; }
// ...more boilerplate

// Simply-MCP: one definition, fully typed
export const addTool = createTool({
  description: 'Add two numbers',
  params: {
    a: { type: 'number', description: 'First' },
    b: { type: 'number', description: 'Second' },
  },
  handler: ({ a, b }) => ({ sum: a + b }),  // Fully typed!
});

CLI

npx simplymcp lint server.ts             # Validate before running
npx simplymcp run server.ts              # Run (stdio)
npx simplymcp run server.ts --port 3000  # Run (HTTP)
npx simplymcp dev server.ts --port 3000  # Dev mode with hot reload
npx simplymcp bundle server.ts           # Bundle for production

Claude Desktop Integration

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["simplymcp", "run", "/path/to/server.ts"]
    }
  }
}

Documentation

Examples

License

Simply-MCP is free for non-commercial use (research, personal projects, education, evaluation). Commercial use requires a separate license. See LICENSE for details.

For commercial licensing: licensing@cwinnov.com

NPM · GitHub · Issues

Built with the Model Context Protocol SDK by Anthropic.