Simple MCP

A simple TypeScript library for creating MCP (Model Context Protocol) servers.

Features

Simple API: Create MCP servers with minimal code
Type Safety: Full TypeScript integration
Parameter Validation: Built-in validation with Zod
MCP Compatible: Fully implements the Model Context Protocol

Related MCP server: MCP Framework

Installation

npm install simple-mcp

Quickstart

import { McpServer } from 'simple-mcp'; import { z } from 'zod'; // Create a server instance const server = new McpServer({ name: 'my-server' }); // Register the tool with the server server.tool({ name: 'greet', parameters: { name: z.string().describe('Person\'s name') }, execute: async ({ name }) => { return { content: [ { type: 'text', text: `Hello, ${name}! Nice to meet you.` } ] }; } }); // Start the server server.start({ transportType: 'stdio' });

Class-based Implementation

You can also implement MCP tools using classes:

import { McpServer, type McpTool } from 'simple-mcp'; import { z, ZodObject } from 'zod'; const parameters = { name: z.string().describe('The name is required'), }; class GreetTool implements McpTool<typeof parameters> { public readonly name = 'greet'; public readonly parameters = parameters; public async execute({ name }: z.infer<ZodObject<typeof this.parameters>>) { return { content: [ { type: 'text', text: `Hello, ${name}! Nice to meet you.`, }, ], }; } } // Initialize a new MCP server with the name 'greet-server' const server = new McpServer({ name: 'greet-server' }); // Create an instance of the GreetTool class const greetTool = new GreetTool(); // Register the tool with the server server.tool(greetTool); // Start the server using stdio as the transport method server.start({ transportType: 'stdio' });