Simple MCP Server

What is Simple MCP?

Simple MCP is a lightweight TypeScript library for building servers that implement the Model Context Protocol (MCP). It provides a minimal API, built-in parameter validation via Zod, and full type safety, making it easy for developers to create custom MCP tools.

How to use Simple MCP?

Install the package with npm install simple-mcp. Then create an McpServer instance, register tools using either a functional or class-based API, and start the server with server.start({ transportType: 'stdio' }). Parameter schemas are defined with Zod and passed inline or through an McpTool interface.

Key features of Simple MCP

• Minimal API for creating MCP servers
• Full TypeScript integration with type safety
• Built-in parameter validation using Zod
• Supports both functional and class-based tool registration
• Implements the Model Context Protocol (MCP) standard
• Ships with ready-to-use example tools (greeting, calculator)

Use cases of Simple MCP

• Building a custom MCP server that exposes a “greet” tool to AI assistants
• Creating a calculator tool that performs mathematical operations via MCP
• Prototyping new MCP tools with minimal boilerplate code
• Embedding MCP compatibility into an existing TypeScript project
• Teaching or learning the Model Context Protocol with a straightforward codebase