sova

by The0wlGuy

297 downloads
Not rated
GitHub

About

TypeScript framework for building MCP servers

Details

Author
The0wlGuy
Downloads
297
Categories
Other

- 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).

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name sova
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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>).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

sova

A TypeScript framework for building MCP servers capable of handling client sessions.

> [!NOTE]
>
> For a Python implementation, see sova.

Features

- Simple Tool, Resource, Prompt definition
- Authentication
- Sessions
- Image content
- Audio content
- Logging
- Error handling
- SSE
- CORS (enabled by default)
- Progress notifications
- Typed server events
- Prompt argument auto-completion
- Sampling
- Automated SSE pings
- Roots
- CLI for testing and debugging

Installation

npm install sova

Quickstart

> [!NOTE]
>
> There are many real-world examples of using sova in the wild. See the Showcase for examples.

import { sova } from "sova";
import { z } from "zod"; // Or any validation library that supports Standard Schema

const server = new sova({
name: "My Server",
version: "1.0.0",
});

server.addTool({
name: "add",
description: "Add two numbers",
parameters: z.object({
a: z.number(),
b: z.number(),
}),
execute: async (args) => {
return String(args.a + args.b);
},
});

server.start({
transportType: "stdio",
});

_That's it!_ You have a working MCP server.

You can test the server in terminal with:

```bash
git clone https://github.com/bounded1999/sova.git
cd sova

pnpm install
pnpm build

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.