trackmcp
Back to directory
tilfin

mcp-serverless

View on GitHub

Serverless implementation of the Model Context Protocol (MCP)

1 stars TypeScriptAI & Machine Learning Updated Jul 11, 2025

Documentation

MCP Serverless

A serverless implementation for the Model Context Protocol (MCP) architecture that enables tool management through a clean interface.

Overview

This package provides a serverless implementation of the MCP server that allows you to:

  • Register and manage tools
  • Handle tool-related requests
  • Create in-memory client-server connections
  • Extend request with context to enable credential transmission from clients

Installation

bash
npm install @tilfin/mcp-serverless

Usage

Tool Registration and create a client for service implements

typescript
import { createService, ToolManager } from '@tilfin/mcp-serverless';

// Create a tool manager
const toolManager = new ToolManager();

// Register tools
toolManager.registerTools([
  {
    name: 'calculator',
    description: 'Performs basic arithmetic operations',
    inputSchema: {
      type: 'object',
      properties: {
        operation: { type: 'string' },
        numbers: { type: 'array', items: { type: 'number' } }
      },
      required: ['operation', 'numbers']
    },
    toolFunction: async (params, ctx) => {
      if (ctx.apiKey !== 'xyz') throw new Error('Invalid API Key');

      let result;
      if (params.operation === 'add') {
        result = params.numbers.reduce((sum, n) => sum + n, 0);
      }
      return { result };
    }
  }
]);

// Create a serverless client
const client = createService(toolManager);

// List available tools
const toolsList = await client.listTools();

// Call a tool
try {
  const result = await client.callTool({
    name: 'calculator',
    arguments: {
      operation: 'add',
      numbers: [1, 2, 3]
    }
  });
} catch (err) {
  // raise Invalid API Key error
}

// Call a tool with context
const result = await client.callTool({
  name: 'calculator',
  arguments: {
    operation: 'add',
    numbers: [1, 2, 3]
  },
  ctx: { apiKey: 'xyz' }
});

API Reference

`ToolManager` class

Manages the registration and handling of tools.

`Tool` Interface

Tools must implement the following interface:

typescript
interface Tool {
  name: string;
  description: string;
  inputSchema: ToolInput;
  toolFunction: (args: CallToolRequestArguments, ctx: CallToolRequestContext) => Promise;
}

`createServer(serverInfo, toolManager)`

Creates an MCP server with the given tool manager.

`createService(toolManager)`

Creates an in-memory client-server setup for serverless operation.

Examples

Standard I/O Transport

The package includes examples for using the stdio transports for both client and server communication:

  • `StdioClientTransport`: Allows clients to communicate with servers over standard input/output
  • `StdioServerTransport`: Enables servers to handle requests through standard input/output

Check out the example implementation:

Frequently asked questions

What is mcp-serverless?

mcp-serverless is Serverless implementation of the Model Context Protocol (MCP)

How do I install mcp-serverless?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-serverless open source?

Yes — it is hosted on GitHub at https://github.com/tilfin/mcp-serverless and has 1 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP