Skip to main content
Glama

mcp-server-template

A Falken's Lab MCP server. The starting point for Falken's Lab's MCP servers: one bundled file, tests, docs in English and Spanish, ready for agent-kit.

Node.js 20+ MCP server License: MIT

🧩 Use this template

This is a template repository: every Falken's Lab MCP server starts here, so they all look and work the same. It's an MCP server over stdio, written in TypeScript with the official MCP SDK and bundled into a single file that runs with npx, so an agent built on agent-kit can run it without installing anything. It comes with one example tool, tests, a strict check of its tools, CI, a documentation site in English and Spanish, and the design notes every server shares.

✨ Why this template

  • πŸ“¦ One file, nothing to install. esbuild bundles every dependency into dist/server.mjs, which agent-kit runs with npx.

  • 🧭 Tools a model chooses well. Each tool has a title, a description for the model, schemas and readOnlyHint, and npm run check fails if one doesn't.

  • πŸ”§ Programs installed apart, explained. A server that needs Docker or ffmpeg declares it once and gets check_requirements and clear errors; it never installs anything.

  • πŸ§ͺ Tested from the start. node:test with the SDK's in-memory transport, and CI on Node 20 and 24.

  • 🌍 Docs in two languages. A Docusaurus site in English and Spanish, with the tools reference generated from the server itself.

  • 🧠 Design memory. .minispec/ with the decisions every Falken's Lab server shares, and a CLAUDE.md for coding agents.

Related MCP server: mcp-toolforge

πŸš€ Quick start

On GitHub, Use this template to create the new repository, then:

npm install
npm run init -- docker-lab-mcp "Hands-on practices in Docker, safe by default."
npm run build && npm run check

init renames the package, the command, the links and the docs, and notes in .minispec/core/stack.md the template's commit it comes from, so later fixes here can be found with git log <commit>..main. Then rewrite .minispec/core/project.md and this README for the new server, and add its tools in src/tools/.

🧰 What's inside

Area

For example

πŸ”Œ Server

src/server.ts (stdio), src/createServer.ts, src/instructions.ts

πŸ› οΈ Tools

server_info, one file per tool in src/tools/, reply() for structured results

πŸ”§ Requirements

src/requirements.ts: check_requirements and needs(), only when a server needs programs

πŸ§ͺ Checks

npm test, npm run check (strict tools/list), typecheck and lint, CI

πŸ“– Docs

docs/, Docusaurus in English and Spanish, published to GitHub Pages by each server (the template only builds it)

🧠 Design

.minispec/ (project, conventions, ADRs), CLAUDE.md

πŸ“š Documentation

The template has no site of its own: docs/ is the one each server publishes. What a new server needs is here:

  • CLAUDE.md: the commands, how the pieces fit, and the skills in .claude/skills/ (adding a tool, checks, docs, releases).

  • .minispec/: the project, its conventions and the decisions every Falken's Lab server shares.

  • docs/: the site's skeleton, with getting started, the tools reference generated from the server and the releases; cd docs && npm install && npm start previews it.

πŸ› οΈ Developing

npm run build, npm test and npm run check before every commit; CLAUDE.md lists every command, and .minispec/ the decisions behind them. Releases are published to npm by the owner.

Made with πŸ’– by Falken's Lab Team

Available Tools

1 tool
server_infoServer infoA
Read-only

Show this server's name, version and data folder, and, for a server that needs programs installed apart, whether they're there. Contains no secrets.

Inputs: no named parameters. Returns: name, node, dataDir, version, +1 more

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of selecting the wrong tool. The tool's purpose is clear from its name and description.

    Naming Consistency5/5

    With a single tool named 'server_info', there is no inconsistency or deviation from a pattern. The snake_case convention is clear and readable.

    Tool Count1/5

    A single trivial tool ('server_info') is an extreme mismatch for any functional MCP server. The server offers no domain operations, only diagnostic information.

    Completeness1/5

    The tool surface is severely incomplete: it only reports server metadata and provides no CRUD or lifecycle operations for any domain. There are no workflows an agent could complete with this server.

    Maintenance

    ActivityNo data
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Generates complete, runnable MCP server projects from natural-language tool descriptions, including schema, implementation, tests, README, and license. It enables AI agents to scaffold standalone MCP servers ready to install and run.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to generate complete, runnable MCP server projects from natural-language tool descriptions, including schema, implementation, tests, README, and license.
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Provides a ready-to-use starter kit for building custom MCP servers, enabling developers to scaffold and register tools with type-safe Zod schemas, run over stdio with auto-bootstrapping, and connect to AI clients like Claude Desktop, Google Antigravity, Cursor, and VS Code.
      3
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides a runnable local stdio Python server scaffold that coding agents extend into custom tool integrations by describing an idea and letting the agent investigate, build, test, and install it. Ships with no prebuilt tools, so it enables guided, agent-assisted creation of MCP tools connected to external APIs, databases, or websites while writes stay disabled until explicitly agreed.
      1
      MIT