Skip to main content
Glama
0xstyles

MCP Server Template

by 0xstyles

MCP Server Template

Minimal template for building Model Context Protocol (MCP) servers with Bun and TypeScript.

Quick Start

bun install
bun run dev    # Development
bun run start  # Production

Configure in Cursor

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "bun",
      "args": ["/path/to/your/project/index.ts"],
      "cwd": "/path/to/your/project"
    }
  }
}

Related MCP server: MCP Boilerplate

Project Structure

├── index.ts          # Server entry point
├── schema.ts         # State schema (Zod)
├── config.ts         # Configuration
├── state.yaml        # State file
├── tools/            # Tool handlers
└── utils/            # State & logging utilities

Features

  • Schema-based state validation (Zod)

  • YAML state persistence

  • Tool usage logging

  • Deep merge for state updates

Usage

Customize State

  1. Update schema.ts to match your state structure

  2. State is automatically validated on read/write

Add Tools

  1. Create tools/your-tool.ts following example-tool.ts pattern

  2. Register in index.ts: registerYourTool(server);

State Operations

import { getState, updateState, saveState } from "./utils/state.ts";
import { type State } from "./schema.ts";

const state = await getState();
await updateState({ version: "1.0.1" }); // Deep merge
await saveState(newState); // Full replacement

Logging

import { log } from "./utils/logger.ts";
await log("info", "tool_name", request, response);

See TEMPLATE.md for detailed examples.

A
license - permissive license
-
quality - not tested
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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/0xstyles/mcp'

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