This MCP server is a TypeScript SDK designed for building and exposing MCP-compliant servers via a fetch-based remote protocol. It focuses on a stateless, server-first model and encourages a minimal API approach in line with the Winter TC spec. To use it, start by creating an MCPServer instance, give it a name and version, and then progressively add tools. Each tool is defined with a name, description, a validator (for input shape validation, typically using Zod), and a handler that implements the tool’s actual logic. After configuring tools, wire a transport (for example HTTPStreamableTransport) and connect it to the server so it can receive and respond to MCP requests. When a request arrives, use the transport to handle the Request and return a properly formatted MCP Response. The README example demonstrates adding a simple add tool that validates two numbers and returns their sum as a text content, then wires an HTTP transport to handle incoming requests.

Prerequisites:

• Node.js (recommended) and npm/yarn installed
• Basic TypeScript development environment if you plan to modify the SDK

Installation steps:

1. Ensure you have Node.js installed. Verify with: node -v npm -v

2. Install the MCP package via npx (as the README suggests for quick setup) or install the package into your project:

   Quick start without local install

   npx -y @zuplo/mcp

   Or add to your project (example using npm):

   npm install @zuplo/mcp

3. If you install locally, import and instantiate MCPServer in your TypeScript/JavaScript project according to the example in the README, then add tools, and wire a transport before handling requests.

4. For a quick prototype, you can run a basic script that constructs the MCPServer, adds tools, and starts listening via a transport as shown in the documentation.

Notes:

• This package follows the MCP (Model Context Protocol) approach and aligns with a fetch-based API surface. It is designed to work in environments like Zuplo, Node, Deno, and Workerd.
• Validators are typically implemented with libraries such as Zod, as shown in the examples. Ensure any validator you use properly describes the expected input shape.
• The server is stateless; ensure your tooling and transport layers manage sessions and state as needed for your application.
• If you encounter type issues during TypeScript compilation, ensure your TypeScript configuration and dependencies align with the MCP SDK requirements.
• The README demonstrates an example tool named 'add' with a simple numeric validator and a handler that returns a text content result.