drio
Open app

MCP Server Starter

Source

An opinionated starter template for making Model Context Protocol (MCP) servers

Catalog onlyCatalog onlySTDIO

Overview

MCP Server Starter is an opinionated starter template designed for building Model Context Protocol (MCP) servers using TypeScript.

To use MCP Server Starter, clone the repository and install the dependencies using the command bun install. You can then create new tools and manage your server configuration as needed.

  • Fast testing and development with Bun - Linting and formatting with Biome - Automated version management using standard-version - Clean and maintainable project structure
  1. Building custom MCP servers for various applications.
  2. Rapid development and testing of new MCP tools.
  3. Managing versioning and publishing of MCP server packages.

Add to your AI client

Use these steps to connect MCP Server Starter in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-starter-template-stevenstavrakis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-starter-template-stevenstavrakis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-starter-template-stevenstavrakis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-starter-template-stevenstavrakis": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-starter-template-stevenstavrakis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-starter-template-stevenstavrakis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-starter-template-stevenstavrakis"
      ]
    }
  }
}

FAQ

Can I customize the tools created with this template?

Yes! The template includes scripts to help you create and customize new MCP tools easily.

Is there a guide for publishing my server to npm?

Yes! The project includes detailed instructions for publishing your server to npm after building it.

What is the purpose of the `bun run` commands?

These commands are used for various development tasks such as testing, formatting, and building the project.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":964,"uuid":"95f3d530-313b-442a-99ca-d22ecfd022cb","name":"mcp-starter-template","title":"MCP Server Starter","description":"An opinionated starter template for making Model Context Protocol (MCP) servers","avatar_url":"https://avatars.githubusercontent.com/u/35231833?v=4","created_at":"2025-01-28T02:21:17.493Z","updated_at":"2025-02-23T07:19:16.282Z","status":"created","author_name":"StevenStavrakis","author_avatar_url":"https://avatars.githubusercontent.com/u/35231833?v=4","tags":"mcp,mcp-starter,server-template","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/StevenStavrakis/mcp-starter-template","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools