@mcpdotdirect/template-mcp-server

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.