sova

What is sova?

sova is a TypeScript framework for building MCP (Model Context Protocol) servers that handle client sessions. It simplifies defining tools, resources, prompts and includes built‑in support for authentication, SSE, image/audio content, logging, and error handling. It is designed for developers who want to create MCP servers with minimal boilerplate.

How to use sova?

Install via npm install sova. Create a server instance, add tools (or resources/prompts) using the addTool method with Standard Schema parameters, then start the server with server.start({ transportType: "stdio" }) or "sse". Use the CLI for testing (npx sova dev <file>) and debugging (npx sova inspect <file>).

Key features of sova

• Simple Tool, Resource, and Prompt definition.
• Authentication and session management.
• SSE transport with automated pings.
• Image and audio content helpers (imageContent, audioContent).
• Typed server events and progress notifications.
• CLI for testing (dev) and debugging (inspect).

Use cases of sova

• Building an MCP server that exposes tools for LLM interaction.
• Creating a server with SSE for remote MCP communication.
• Handling client sessions with authentication and logging.
• Returning rich content (images, audio) from tool calls.
• Implementing progress reporting and sampling in tools.

FAQ from sova

How do I test or debug a sova server?

Use the CLI: npx sova dev src/examples/addition.ts to run a live test server, or npx sova inspect src/examples/addition.ts to open the MCP Inspector.

What are the runtime requirements and dependencies?

sova runs on Node.js with npm. It uses the Standard Schema specification; any validation library (Zod, ArkType, Valibot) that implements it can be used. Valibot additionally requires @valibot/to-json-schema as a peer dependency.

How do I return images or audio from a tool?

Use the built‑in imageContent and audioContent helpers. They accept a URL, file path, or buffer, and return the correct MCP content object.

How does sova handle errors intended for the user?

Throw a UserError instance inside a tool’s execute function. This error is shown to the user rather than causing an internal failure.

What transports does sova support?

sova supports stdio for local communication and SSE (Server‑Sent Events) for remote MCP connections. SSE is configured via server.start({ transportType: "sse", sse: { endpoint, port } }).