@mcpdotdirect/template-mcp-server

Name: @mcpdotdirect/template-mcp-server
Author: mcpdotdirect

@mcpdotdirect

Repository

About @mcpdotdirect/template-mcp-server

Template to quickly set up your own MCP server

#agent #template #boilerplate #mcp #mcp-server #mcp-server-template

Basic information

Config

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

{
  "mcpServers": {
    "template-mcp-server": {
      "command": "npx",
      "args": [
        "@mcpdotdirect/create-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is @mcpdotdirect/template-mcp-server?

It is a CLI tool to quickly scaffold a new Model Context Protocol (MCP) server using the FastMCP framework. It includes basic server setup with stdio and HTTP transport, TypeScript configuration, development scripts, and a structure for defining MCP tools, resources, and prompts.

How to use @mcpdotdirect/template-mcp-server?

Run npx @mcpdotdirect/create-mcp-server or npm init @mcpdotdirect/mcp-server to create a new project. Then install dependencies and start the server with npm start for stdio or npm run start:http for HTTP. Connect from Cursor via Settings > MCP Servers, or use a .cursor/mcp.json file.

Key features of @mcpdotdirect/template-mcp-server

Built using the FastMCP framework for simpler implementation
Supports both stdio and HTTP (SSE) transport
Full TypeScript support for type safety
Extensible: easy to add custom tools, resources, and prompts

Use cases of @mcpdotdirect/template-mcp-server

Quickly scaffold a new MCP server project
Develop local CLI-based MCP tools using stdio transport
Build shared MCP servers accessible over the network via HTTP/SSE
Customize and extend with custom tools, resources, and prompts

FAQ from @mcpdotdirect/template-mcp-server

What transport methods does the template support?

The template supports two transport methods: stdio (command line mode, runs locally, managed automatically by Cursor) and SSE (HTTP mode, can run locally or remotely, communicates over the network, can be shared across machines).

How do I connect my MCP server to Cursor?

In Cursor, go to Settings > Features > MCP Servers and click "Add new MCP server". For stdio mode use type: command with your start command; for SSE mode use type: url with http://localhost:3001/sse. You can also create a .cursor/mcp.json file for portability.

Can I use a different runtime instead of Bun?

Yes. The default scripts in package.json use Bun (e.g., bun run src/index.ts). You can modify the scripts in package.json to use Node.js or another runtime of your choice.

How do I test my MCP server?

FastMCP provides built-in tools: use npx fastmcp dev server.js for development with auto-reload, or npx fastmcp inspect server.ts to inspect your server's tools, resources, and prompts.