Kervan: MCP servers from a YAML spec or TypeScript.
Kervan is a framework for Model Context Protocol servers. Describe HTTP tools in a kervan.yaml file and serve them with one command, or write tools in TypeScript on the official MCP SDK — both run on the same core.

// HIGHLIGHTS
YAML or TypeScript
A spec for tools that call HTTP APIs, code for everything else. Once registered, both behave the same.
Secure by default
SSRF protection, secret redaction, per-tool rate limits and sandboxed response selection — each covered by tests.
Runs anywhere
stdio for local clients, stateless Streamable HTTP for remote ones, or a standard Fetch handler.
Optional Studio
A self-hosted web UI for servers, secrets, users and logs. Every server still exports as plain kervan.yaml.
// AT A GLANCE
- Status
- Preview — v0.1 in preparation
- License
- MIT, open source
- Runtime
- TypeScript on Node.js 22 or 24
- Protocol
- Model Context Protocol (MCP)