Simple MCP

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

FAQ from Simple MCP

What is Simple MCP used for?

Simple MCP is a library for creating MCP servers. Developers use it to define tools that AI models can invoke through the Model Context Protocol.

How do I install Simple MCP?

Run npm install simple-mcp in your project. The library requires a TypeScript environment and Zod as a peer dependency.

Does Simple MCP support transports other than stdio?

The README only demonstrates the stdio transport. Other transports (e.g., HTTP, WebSocket) are not mentioned in the documentation.

Is Simple MCP type-safe?

Yes. The library is written in TypeScript and uses Zod for runtime schema validation, ensuring inputs match the expected types.

What are the runtime requirements for Simple MCP?

Simple MCP runs in any environment that supports Node.js and TypeScript. It depends on Zod for parameter validation.