Simply MCP

Name: Simply MCP
Author: noname9091

@noname9091

代码仓库

关于 Simply MCP

simply a TypeScript framework for building MCP servers

#typescript #mcp #framework

基本信息

分类

其他

许可证

MIT license

运行时

node

传输方式

stdio

发布者

noname9091

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.