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

Termany

thinkany-ai

Agent-Native Terminal

174

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

Ramen

bkraad47

Multi-zone MCP server for GKE/EKS/AKS: Python tools from git, NeMo guardrails, SSO, autoscaling.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

50
Advertise