Advertise
MCP.so
Sign In

MCP Boilerplate

@grossomanache

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

grossomanache

About MCP Boilerplate

No overview available yet

#mcp-server#boilerplate#typescript

MCP Boilerplate config

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

{
  "mcpServers": {
    "mcp-server-boilerplate-grossomanache": {
      "command": "bun",
      "args": [
        "run",
        "src/index.ts"
      ]
    }
  }
}

MCP Boilerplate tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Overview

What is mcp-boilerplate?

mcp-boilerplate is a starter template for building Model Context Protocol (MCP) servers, using Bun as the runtime and TypeScript for type safety. It includes a basic echo tool to demonstrate tool listing, invocation, and error handling, and is designed for quick testing with Claude Desktop.

How to use mcp-boilerplate?

Install dependencies with bun install, then run the server with bun run src/index.ts. For local development, build with bun run build and point Claude Desktop to the compiled dist/index.js. Alternatively, run via Docker Compose using a TCP/port setup with socat.

Key features of mcp-boilerplate

  • Built with Bun and TypeScript
  • Includes an echo tool for basic testing
  • Demonstrates error handling and tool listing
  • Supports both Docker and local execution
  • Ready for integration with Claude Desktop

Use cases of mcp-boilerplate

  • Starting point for developing custom MCP servers
  • Prototyping MCP tools and testing functionality
  • Learning the Model Context Protocol with a minimal example

Frequently asked questions

1

What dependencies are required?

Bun is required to install dependencies and run the server. For the Docker option, Docker and Docker Compose must be installed.

2

How do I test mcp-boilerplate with Claude Desktop?

Two options are provided: run the server via Docker Compose (TCP) and configure Claude Desktop to use a socat container, or build the project with `bun run build` and point Claude Desktop directly to the compiled JavaScript file.

3

What tools does the server provide?

The server includes an echo tool that repeats a provided message, and supports tool listing and rudimentary error handling (e.g., calling echo without a message).

4

How do I build the project?

Run `bun run build` in the project directory. The output will be placed in `dist/index.js`.

5

Does mcp-boilerplate require Claude Desktop to run?

No, but the README focuses on testing with Claude Desktop. The server can be run standalone via `bun run src/index.ts` after installing dependencies.

Comments

More Developer Tools MCP servers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

Meticulous

Meticulous

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

1

Codex Pets

astandrik

Public read-only MCP server for discovering, inspecting, installing, and sharing approved Codex-compatible animated pet packs.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32
Advertise