Skip to main content
Glama

mcp-server-starter

A production-grade starting point for a Model Context Protocol server — stdio and Streamable HTTP from one codebase, zod-validated tools, real error handling, hermetic client-level tests, and an MCPB manifest for one-click install in Claude Desktop.

Two worked example tools, each teaching a real pattern:

  • get_weather — wrap an external API, shape the result, fail usefully (runs with zero API keys)

  • notes_add / notes_list / notes_get / notes_delete — own state, CRUD, input validation, safe destructive naming

Quick start

npm install
npm run smoke        # build + hermetic client-level tests (3/3 as shipped)
npm start            # stdio — Claude Desktop, Cursor, ...
npm start -- --http  # Streamable HTTP on http://localhost:3001/mcp

The Streamable HTTP path is wire-verified (initialize → tools/list → DELETE round trip against the current SDK).

Related MCP server: Server MCP

What this repo doesn't include

This starter ships free from the full kit, which adds:

  • the Python twin starter (same patterns, one file)

  • the tool-design guide — naming, schemas, failure modes, and why LLM clients misuse badly-designed tools

  • the July 2026 spec-transition map — the stateless core explained, what breaks (nothing yet), and the two independent migrations everyone confuses

  • a spec-driven generator — describe tools in JSON, get a working, test-verified server out

  • packaging + deploy configs — .mcpb one-click packaging, Dockerfile, systemd unit, Procfile

  • a service-intake template if you want to sell builds yourself

→ The full kit: https://wisetechysolutions.github.io/mcp-server-starter/

License

MIT for this repository. The full kit is a separate product under its own license.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to access external services including weather data, file system operations, and SQLite database interactions through a standardized JSON-RPC interface. Features production-ready architecture with security, rate limiting, and comprehensive error handling.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides math and weather tools accessible via LangGraph agent using MCP protocol with stdio and streamable HTTP transports.
      1
      -
    • A
      license
      B
      quality
      B
      maintenance
      Shared memory for AI coding agents (Claude Code, Codex, Cursor and others) in one local SQLite file, over MCP or REST. Every note records which agent wrote it and keeps its history; writes that match known prompt-injection patterns are held for your review; you can roll back everything one writer did. Runs on your machine, no cloud or API keys, MIT licensed.
      7
      1,441 npm
      9
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides AI clients with real-time tools for math evaluation, timezone-aware time lookup, live weather retrieval, and persistent note management, all accessible over the Model Context Protocol via stdio.
      6
      2
      MIT