About fastmcp-boilerplate
fastmcp-boilerplate is a TypeScript starter project for building MCP servers with FastMCP. It provides a small example module and test, plus commands for running and inspecting the server.
Key features
- 01FastMCP server starter
- 02TypeScript project structure
- 03Example add function
- 04Example test
- 05MCP Inspector run command
Use cases
- 01Start a FastMCP server project
- 02Try a basic server function and test
- 03Inspect a server through a Web UI
MCP support
This is a boilerplate for creating MCP servers with FastMCP. The included commands run the server or open it in 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.