Skip to main content
Glama
falkenslab

mcp-server-template

by falkenslab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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.

npm Node.js 20+ MCP server License: MIT

📖 Documentation · 📖 Documentación en español

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. 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

🧠 Design

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

📚 Documentation

  • Getting started: installing the server in an agent or in Claude Code.

  • Tools: every tool, generated from the server.

🛠️ 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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-tap

    yulinlina
    A
    license
    Not graded
    quality
    C
    maintenance
    This MCP server is a zero-config CLI tool that lets developers tap into any stdio-based MCP server from their terminal, enabling them to list tools/resources/prompts, call tools with JSON arguments, and health-check servers without requiring a full AI client or browser setup.
    1
    MIT

  • mcp-toolforge

    prem-the-dev
    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

  • mcp-toolforge

    itsPremkumar
    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

  • smrtm-mcp

    looizinho
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables building and running an MCP server with automatically discovered tools, prompts, and resources over HTTP or STDIO, using TypeScript and Zod schemas.
    -