Function createServer

createServer(options: CreateServerOptions): CreateServerResult

Create an MCP server with automatic tool, resource, and prompt registration.

This is the recommended way to create servers in the framework. It automatically discovers and registers all items defined with defineTool(), defineResource(), defineResourceTemplate(), and definePrompt().

Parameters

options: CreateServerOptions
Server configuration options

Returns CreateServerResult

Server instance with start() and stop() methods

Example

// Minimal server with stdio transport
import { createServer, defineTool, text } from 'mcp-server-framework';
import { z } from 'zod';

// This tool is auto-registered when the module loads
export const greetTool = defineTool({
  name: 'greet',
  description: 'Greet a user',
  input: z.object({ name: z.string() }),
  handler: async ({ name }) => text(`Hello, ${name}!`),
});

// Create and start server
const server = createServer({
  name: 'greeting-server',
  version: '1.0.0',
  transport: { mode: 'stdio' },
});

await server.start();

Example

// Server with HTTP transport
const server = createServer({
  name: 'http-server',
  version: '1.0.0',
  transport: { mode: 'http', port: 3000 },
});

await server.start();

Function createServer

Parameters

Returns CreateServerResult

Example

Example

Settings