Skip to main content
Glama
currentspace

Bootstrap MCP Server

by currentspace

Bootstrap MCP Server

A minimal MCP (Model Context Protocol) server template with hot reload support for development.

Features

  • Hot Reload Proxy: Maintains connection with Claude while allowing server restarts

  • Common Tool Patterns: Example implementations of typical MCP tools

  • TypeScript Support: Full TypeScript with strict type checking

  • Fast Build System: Uses esbuild for quick compilation

  • Development Ready: Configured with ESLint and Prettier

Related MCP server: MCP Template

Quick Start

  1. Install dependencies:

    pnpm install
  2. Build the project:

    pnpm run build
  3. Start the MCP server:

    ./start_mcp.sh
  4. To reload the server during development:

    ./reload_mcp.sh

Project Structure

bootstrap_mcp/
├── src/
│   ├── server.ts    # Main MCP server implementation
│   └── proxy.ts     # Hot reload proxy
├── dist/            # Compiled JavaScript output
├── build.mjs        # Build configuration
├── tsconfig.json    # TypeScript configuration
├── package.json     # Project dependencies
├── start_mcp.sh     # Start script with proxy
└── reload_mcp.sh    # Reload script for development

Available Tools

The bootstrap includes three example tools:

  1. hello_world: Simple greeting tool

  2. echo: Echo back messages

  3. get_time: Get current timestamp

Development Workflow

  1. Make changes to src/server.ts

  2. Run ./reload_mcp.sh to rebuild and restart

  3. The proxy maintains the Claude connection during restart

  4. Check /tmp/bootstrap-mcp-debug.log for debugging

Adding New Tools

  1. Add tool definition to TOOLS array in server.ts

  2. Implement handler method in BootstrapMCPServer class

  3. Add case in CallToolRequestSchema handler

  4. Reload the server

Scripts

  • pnpm run dev: Development mode with tsx watch

  • pnpm run build: Build TypeScript to JavaScript

  • pnpm run typecheck: Type checking only

  • pnpm run lint: Run ESLint

  • pnpm run format: Format code with Prettier

Requirements

  • Node.js v24+

  • pnpm package manager

Available Tools

3 tools
echoB

Echo back the provided message

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYesMessage to echo

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the echo action but doesn't mention any behavioral traits like whether it modifies input, has rate limits, requires authentication, or what format the output takes. 'Echo back' implies a simple return, but no details are given about the return mechanism or potential side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with zero wasted words. It's appropriately sized for a simple tool and front-loads the core functionality immediately.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple 1-parameter tool with no annotations and no output schema, the description is minimally adequate. It states the basic purpose but lacks details about output format or behavioral context that would be helpful given the absence of structured fields. It's complete enough to understand what it does but not rich in operational guidance.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the parameter 'message' fully documented in the schema as 'Message to echo'. The description doesn't add any meaning beyond what the schema provides about parameters, so it meets the baseline of 3 when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function ('Echo back') with the specific resource ('the provided message'), making the purpose immediately understandable. It doesn't distinguish from siblings like 'get_time' or 'hello_world', but the verb+resource combination is specific enough for basic understanding.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives like 'hello_world' (which might return a fixed greeting) or 'get_time' (which returns time data). The description only states what it does, not when it should be selected over sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_timeB

Get the current time

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('Get the current time') but lacks details on format, timezone, permissions, or error handling, which are important for a time-fetching tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise and front-loaded with a single, clear sentence that directly states the tool's function. There's no wasted wording, making it highly efficient for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple, parameterless tool with no output schema, the description is minimally adequate. However, it lacks details on return format (e.g., timestamp vs. string) and behavioral context, which could help the agent use it more effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters with 100% coverage, so no parameter documentation is needed. The description doesn't add parameter details, which is appropriate, but a perfect score is reserved for cases where it actively compensates for schema gaps.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Get') and resource ('current time'), making it immediately understandable. However, it doesn't differentiate from sibling tools like 'echo' or 'hello_world', which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'echo' or 'hello_world'. There's no mention of context, prerequisites, or exclusions, leaving the agent with minimal usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

hello_worldD

A simple hello world tool

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName to greet

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden for behavioral disclosure. The description offers no information about what the tool actually does, how it behaves, what it returns, or any operational characteristics. 'Simple hello world tool' doesn't explain whether this performs a greeting action, displays output, or has any side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

While technically concise with just four words, this is a case of under-specification rather than effective conciseness. The description fails to communicate essential information about the tool's purpose and behavior. Every sentence should earn its place, and this single sentence provides minimal value beyond what's already implied by the tool name.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and a description that provides almost no useful information, this is completely inadequate. The description doesn't explain what the tool does, when to use it, what it returns, or how it behaves. For even a simple tool with one parameter, this description fails to provide the minimal contextual information needed for an agent to understand and use the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with the single parameter 'name' well-documented as 'Name to greet'. The description adds no additional parameter information beyond what the schema provides. With complete schema coverage, the baseline score of 3 is appropriate since the schema does the heavy lifting for parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'A simple hello world tool' is a tautology that essentially restates the tool name 'hello_world' without specifying what the tool actually does. It mentions 'hello world' which implies greeting functionality, but doesn't clearly state the verb+resource combination or distinguish this from sibling tools like 'echo' or 'get_time'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of appropriate contexts, prerequisites, or comparisons to sibling tools like 'echo' or 'get_time'. The agent receives no help in determining when this specific greeting tool should be selected.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updates
    • First observedecho
    • First observedget_time
    • First observedhello_world

TDQS

C2.7/5.0
Disambiguation5/5

Each tool has a clearly distinct and non-overlapping purpose: echo returns a message, get_time provides the current time, and hello_world outputs a greeting. There is no ambiguity or confusion between these simple, well-defined functions.

Naming Consistency4/5

The naming follows a consistent verb-based pattern (echo, get_time, hello_world), with all tools using snake_case. The minor deviation is that 'hello_world' is more of a phrase than a verb-noun pair, but it still fits the overall readable style.

Tool Count3/5

With only 3 tools, this server feels thin for a general-purpose 'Bootstrap' server, as it lacks depth in any specific domain. However, for a minimal or demo server, the count is reasonable but borderline in terms of providing substantial utility.

Completeness2/5

As a 'Bootstrap' server, the toolset is severely incomplete, covering only trivial echo, time, and greeting functions without any meaningful domain coverage or CRUD operations. It lacks obvious extensions for common bootstrap tasks like configuration or setup utilities.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A hot-reload development tool that enables real-time development of MCP (Model Context Protocol) servers by automatically reloading tools as they're modified without requiring manual restarts.
    14
    11
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A production-ready Model Context Protocol server template in TypeScript that enables building MCP servers with dynamic tool registration, dual transport (stdio + HTTP), and pluggable authentication.
    15
    MIT
  • F
    license
    C
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server template built with mcp-framework, providing a foundation for creating custom tools and publishing npm packages.
    2
    -
  • A
    license
    A
    quality
    D
    maintenance
    A simple Model Context Protocol server that provides a hello world greeting tool, serving as a boilerplate template for quickly creating new MCP servers.
    1
    16
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/currentspace/bootstrap_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server