starter-lite
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Server Starter (lite)
A small TypeScript MCP server that runs over stdio, with two example tools and tests. Run it in Claude Desktop, Claude Code, Cursor or VS Code, then replace the examples with your own tools.
Built on the official MCP TypeScript SDK v2 (@modelcontextprotocol/server).
MIT licensed.
Quick start
Requires Node.js 20 or newer. Clone this repository, then:
npm install
npm test
npm run buildnpm test starts the server as a child process and talks to it over stdio
with the official MCP client, the same way your editor does. No network
needed.
npm run build writes dist/index.js. That is the file your client starts.
Related MCP server: Simple-MCP-Server
Connect a client
Each client starts the server itself, so it needs the absolute path to
dist/index.js. Run pwd in this folder to get it, and run npm run build
again after every change.
Claude Code
claude mcp add starter-lite -- node /absolute/path/to/mcp-server-starter-lite/dist/index.jsClaude Desktop: Settings > Developer > Edit Config opens
claude_desktop_config.json. Add the server, then restart Claude Desktop:
{
"mcpServers": {
"starter-lite": {
"command": "node",
"args": ["/absolute/path/to/mcp-server-starter-lite/dist/index.js"]
}
}
}Cursor: the same mcpServers block in ~/.cursor/mcp.json (all
projects) or .cursor/mcp.json (one project).
VS Code (Copilot agent mode): .vscode/mcp.json:
{
"servers": {
"starter-lite": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/mcp-server-starter-lite/dist/index.js"]
}
}
}Then ask your assistant something like "What time is it in Tokyo?" or "Convert 42 km to miles".
MCP Inspector: npm run inspect opens the Inspector in your browser,
connected to the built server, so you can call the tools by hand.
The two tools
Tool | What it shows |
| The smallest useful tool: one input with a default, structured output, and a readable error for an unknown time zone. Copy it to start your own. |
| A pure function behind a tool: validated input, a lookup table, structured output, and an error the model can recover from. |
Add your own tool
Copy
src/tools/time.tstosrc/tools/<name>.tsand rename the function and the tool.Add it to the
moduleslist insrc/tools/index.ts.Add a test in
test/tools.test.ts.Run
npm run typecheck && npm test, thennpm run buildand restart your client.
Rules worth keeping (they are also in AGENTS.md, so Claude Code or Cursor
follow them when you ask them to add a tool):
Describe every input field with
.describe(). The model reads it to decide what to pass.Name tools with kebab-case verbs:
search-orders,create-invoice.Set
annotations, so clients know whether a tool only reads or also changes things.Return
toolError(message)for expected failures. Throw only for real bugs.Never write to stdout (
console.log). Over stdio, stdout carries the protocol and one stray line breaks it. Uselogfromsrc/lib/log.ts, which writes to stderr.
Project layout
src/index.ts stdio entry point
src/server.ts builds the MCP server and registers the tools
src/tools/index.ts the list of tools
src/tools/time.ts current-time
src/tools/convert.ts convert-units
src/lib/log.ts logger that writes to stderr
test/tools.test.ts runs the server over stdio with a real MCP client
AGENTS.md rules for AI coding assistantsLite and the full kit
This repo is the free, stdio-only part of the MCP Server Starter Kit. Stdio is enough while the server runs on your own machine. The full kit is for when it needs to run somewhere else and be shared:
Lite (this repo) | Full kit | |
stdio for local clients | Yes | Yes |
Remote server over Streamable HTTP, stateless 2026-07-28 spec | No | Yes |
Auth: API keys, or OAuth with per-tool scopes | No | Yes |
Deploy: Cloudflare Workers, Vercel, Node, Docker | No | Yes |
Example tools | 2 | 7: notes with per-user storage, an external API with timeouts, unit conversion, caller identity |
Resources and prompts | No | Yes |
Storage: Workers KV or Upstash Redis | No | Yes |
Tests | 7 | 27 |
Guides | This README | 8 step-by-step guides |
License | MIT | Commercial, one-time payment |
You can try the full kit before buying: its live demo runs on Cloudflare Workers, and the page shows how to connect Claude Code, Cursor or VS Code to it.
License
MIT, see LICENSE. The full kit is sold separately under its own license.
I'm Bogdan and I make Kitwire. If something in this repo is unclear or does not work, open an issue and I will fix it.
Bogdan
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Tiny devtools MCP server: slugs, timestamps, case conversion, hashing, base64, UUIDs.
Read-only developer, date, finance, and text utilities. Authless remote MCP server by Clean.tools.
Related MCP Servers
- AlicenseDqualityCmaintenanceA lightweight MCP server that provides date and time tools, including the ability to retrieve current timestamps and parse date strings with IANA timezone support. It enables AI models to interact with the host OS clock and perform temporal calculations via stdio transport.311 npm7MIT
- AlicenseNot gradedqualityDmaintenanceProvides MCP servers (stdio and HTTP) with tools for calculation, text statistics, and unit conversion, plus an agent host that uses Gemini to orchestrate tool calls across them.ISC
- FlicenseNot gradedqualityDmaintenanceEnables assistants to retrieve the current time and convert times between time zones through callable MCP tools over streamable HTTP.-
- AlicenseAqualityCmaintenanceProvides 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.62MIT