About fastmcp-boilerplate
A Bun and FastMCP starter project for developers building TypeScript MCP servers, with an example function and test.
Key features
- 01FastMCP server scaffold
- 02Bun-based setup and run commands
- 03Example add function
- 04Example test
- 05MCP Inspector support
Use cases
- 01Starting a TypeScript MCP server
- 02Testing an example function
- 03Inspecting a server through a web UI
MCP support
It provides a starter structure for building MCP servers with FastMCP. The README describes running the server and inspecting it with MCP Inspector.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEfastmcp-boilerplate
A boilerplate project for building MCP servers using FastMCP, a TypeScript framework for building Model Context Protocol (MCP) servers.
Prerequisites
This project uses Bun, a fast all-in-one JavaScript runtime, package manager, and bundler. You can install it following the official documentation.
Getting Started
To install dependencies:
bun install
To run the project:
bun run index.ts
To run tests:
bun test
Another way to run the server is to use the official MCP Inspector to inspect your server with a Web UI:
bun run inspect
Project Structure
src/index.ts: Main entry point for the MCP serversrc/add.ts: Example module with an add functionsrc/add.test.ts: Example test for the add function
About
This project is a boilerplate inspired by the fastmcp-boilerplate.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.