Module mcp-server-framework

MCP Server Framework

A production-ready framework for building Model Context Protocol servers. Provides a clean, type-safe API for defining tools, resources, and prompts.

Example: Basic Server Setup

import { createServer, defineTool, text, z } from 'mcp-server-framework';

const healthTool = defineTool({
  name: 'health',
  description: 'Check server health',
  input: z.object({}),
  handler: async () => text('OK'),
});

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

await start();

Subpath Imports (Advanced)

Internal modules are available via subpath imports for advanced use cases:

import { ConnectionStateManager } from 'mcp-server-framework/connection';
import { SessionManagerImpl } from 'mcp-server-framework/session';
import { startHttpTransport, createExpressApp } from 'mcp-server-framework/http';
import { getActiveSpan, SpanKind } from 'mcp-server-framework/telemetry';
import { FrameworkErrorFactory } from 'mcp-server-framework/errors';
import { Logger } from 'mcp-server-framework/logger';
import { getFrameworkConfig } from 'mcp-server-framework/config';