cyberneticlibrary
← library

Build lightweight schema-agnostic MCP servers

tmcpmcp_serversetup L2★0
paoloricciuti/tmcp ↗
What it does

Build schema-agnostic MCP servers with unified API

Best for

Building lightweight MCP server code with pluggable validation libraries and minimal dependencies.

Inputs
  • · Tool/resource/prompt definitions
  • · Schema validators (Zod, Valibot, ArkType, Effect, Zod v3)
Outputs
  • · Registered MCP tools, resources, prompts
  • · Type-safe request handlers
Requires
  • · @tmcp/adapter-zod or @tmcp/adapter-valibot or similar
  • · @modelcontextprotocol/sdk (peer dep >= 1.29.0)
Preconditions
  • · Node.js
  • · tmcp package
  • · Chosen schema adapter (optional if skipping validation)
Failure modes
  • · tool.structured cannot be passed to tool.mix (but can be 2nd arg)
  • · Without schema adapter, server cannot accept typed inputs
  • · Return helpers (tool.text, tool.media) reduce boilerplate but limit structure
Trust signals
  • · Multiple schema adapters supported (Zod, Valibot, ArkType, Effect)
  • · Return helpers (tool.text, tool.media, tool.mix) reduce boilerplate
  • · Unified imperative API across all MCP concepts
  • · Zero weird dependencies (minimal SDK only)
  • · v1.0 published (breaking changes possible in minors)