fastmcp-boilerplate

@kyrelldixon

About fastmcp-boilerplate

A simple boilerplate for creating MCP servers with bun and fastmcp

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "fastmcp-boilerplate": {
      "command": "bun",
      "args": [
        "run",
        "index.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is fastmcp-boilerplate?

A boilerplate project for building MCP servers using FastMCP, a TypeScript framework for the Model Context Protocol. It is intended for developers who want to quickly start creating MCP servers with a ready-to-use structure and example code.

How to use fastmcp-boilerplate?

Install dependencies with bun install, then run the server with bun run index.ts. You can run tests with bun test or launch the MCP Inspector for a web UI using bun run inspect.

Key features of fastmcp-boilerplate

Based on the FastMCP TypeScript framework
Uses Bun as runtime, package manager, and bundler
Includes an example add module and test
Supports MCP Inspector for debugging
Minimal, easy-to-extend project structure

Use cases of fastmcp-boilerplate

Quickly bootstrap a new MCP server project
Learn FastMCP patterns and project layout
Test and debug MCP tools with the Inspector
Extend with custom resources, tools, or prompts

FAQ from fastmcp-boilerplate

What runtime is required?

Bun is required as the JavaScript runtime, package manager, and bundler. Install it from the official documentation.

How do I install dependencies and run the server?

Run bun install to install dependencies, then bun run index.ts to start the server.

How can I test or inspect the server?

Run bun test to execute the included tests, or bun run inspect to open the MCP Inspector in a web UI.

What is the project structure?

The main entry point is src/index.ts. There is an example module src/add.ts and a corresponding test file src/add.test.ts. Additional tools and resources can be added following this pattern.

Frequently asked questions

What runtime is required?

Bun is required as the JavaScript runtime, package manager, and bundler. Install it from the official documentation.

How do I install dependencies and run the server?

Run `bun install` to install dependencies, then `bun run index.ts` to start the server.

How can I test or inspect the server?

Run `bun test` to execute the included tests, or `bun run inspect` to open the MCP Inspector in a web UI.

What is the project structure?

The main entry point is `src/index.ts`. There is an example module `src/add.ts` and a corresponding test file `src/add.test.ts`. Additional tools and resources can be added following this pattern.

Comments

Basic information

More Developer Tools MCP servers

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.