mcp-server-template
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-template show me the server info"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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 withnpx.π§ Tools a model chooses well. Each tool has a title, a description for the model, schemas and
readOnlyHint, andnpm run checkfails if one doesn't.π§ Programs installed apart, explained. A server that needs Docker or ffmpeg declares it once and gets
check_requirementsand clear errors; it never installs anything.π§ͺ Tested from the start.
node:testwith 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 aCLAUDE.mdfor 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 checkinit 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 |
|
π οΈ Tools |
|
π§ Requirements |
|
π§ͺ Checks |
|
π Docs |
|
π§ Design |
|
π 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 startpreviews 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 toolserver_infoServer infoARead-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
Scored across 1 tool
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.
With a single tool named 'server_info', there is no inconsistency or deviation from a pattern. The snake_case convention is clear and readable.
A single trivial tool ('server_info') is an extreme mismatch for any functional MCP server. The server offers no domain operations, only diagnostic information.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Nifty's MCP server β exposes tasks, projects, messages, and files as tools for AI agents.
MCP-first toolbox for agents: KV storage, auth, queue, and utility tools. Free in early access.
Create guides as MCP servers to instruct coding agents to use your software (library, API, etc).
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceGenerates 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
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate complete, runnable MCP server projects from natural-language tool descriptions, including schema, implementation, tests, README, and license.MIT
- AlicenseCqualityBmaintenanceProvides 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.31MIT
- AlicenseNot gradedqualityCmaintenanceProvides 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.1MIT