Simply MCP

Name: Simply MCP
Author: noname9091

@noname9091

Repository

About Simply MCP

simply a TypeScript framework for building MCP servers

#typescript #mcp #framework

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "simply": {
      "command": "npx",
      "args": [
        "sova",
        "dev",
        "src/examples/addition.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Simply MCP?

Simply MCP is a TypeScript framework for building MCP (Model Context Protocol) servers that can handle client sessions. It provides simple tool, resource, and prompt definitions, along with built-in support for authentication, logging, error handling, and multiple transport options. The framework is designed for developers who want to quickly create MCP servers with minimal boilerplate.

How to use Simply MCP?

Install the package via npm (npm install sova), import sova from simply, create a server instance with a name and version, add tools using the addTool method with Zod (or any Standard Schema library), and start the server (e.g., server.start({ transportType: "stdio" })). Use the CLI commands npx sova dev <file> to test or npx sova inspect <file> to debug.

Key features of Simply MCP

Simple Tool, Resource, and Prompt definition
Authentication and session management
Image and audio content support
Logging and structured error handling
SSE transport with CORS enabled by default
Progress notifications and prompt argument auto‑completion
Automated SSE pings and Roots support

Use cases of Simply MCP

Exposing executable functions (tools) for LLM clients to perform actions
Providing real-time updates via Server-Sent Events (SSE) for remote MCP communication
Returning mixed content types (text, image, audio) from a single tool
Building testable and debuggable MCP servers using built-in CLI tooling

FAQ from Simply MCP

What validation libraries does Simply MCP support?

Simply MCP uses the Standard Schema specification, so you can use Zod, ArkType, or Valibot (with the @valibot/to-json-schema peer dependency) for defining tool parameters.

How do I run a Simply MCP server with SSE?

Call server.start({ transportType: "sse", sse: { endpoint: "/sse", port: 8080 } }). This starts the server listening for SSE connections on http://localhost:8080/sse.

Does Simply MCP support returning images and audio?

Yes. Use the imageContent and audioContent helper functions (from sova) to return content objects for images or audio, specifying a URL, file path, or buffer.

How can I test a Simply MCP server?

Run npx sova dev <file> to test with the MCP CLI, or npx sova inspect <file> to inspect with the MCP Inspector.

Are there any runtime dependencies for Simply MCP?

Simply MCP requires Node.js and the sova npm package. For Valibot, the peer dependency @valibot/to-json-schema is needed. No other external services are required.