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.