Skip to main content
Glama
olaservo

mcp-maintainer-toolkit

by olaservo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

MCP Maintainer Toolkit

IMPORTANT

This repository is archived and no longer maintained.

It targets MCP TypeScript SDK v1 (@modelcontextprotocol/sdk), which has been superseded by the v2 packages (@modelcontextprotocol/server, /client, /core, …). A complete, reviewed v1 → v2 migration exists on the chore/migrate-mcp-sdk-v2 branch and in PR #58 (closed unmerged) if you want to fork and continue from it.

mcp-maintainer-toolkit remains published on npm at 0.1.5; archiving does not unpublish it, but it will receive no further updates.

Known defect, unfixed: a single module-scope McpServer is shared across all Streamable HTTP sessions. Server._clientCapabilities is one field overwritten by the most recent session, so a session that advertised elicitation can have it overwritten by one that did not — a later elicitationAllOptional call then hangs for the full 10-minute request timeout. Anyone reviving this should restructure around SDK v2's createMcpHandler / McpServerFactory, which gives each session its own server instance.

A Model Context Protocol (MCP) server with utilities to help with maintaining MCP repositories. This toolkit provides various tools and utilities for repository maintenance, testing, and development workflows.

Features

  • Multiple Transport Support: STDIO, SSE, and Streamable HTTP transports

  • Comprehensive Testing Tools: Tools for testing various MCP features and edge cases

  • Rich Parameter Types: Support for complex nested objects, arrays, and conditional parameters

Related MCP server: Easy MCP Server

Installation

npm install -g mcp-maintainer-toolkit

Or install locally:

npm install mcp-maintainer-toolkit

Usage

Command Line

After global installation, you can run the server directly:

# Start with STDIO transport (default)
mcp-maintainer-toolkit

# Start with SSE transport
mcp-maintainer-toolkit sse

# Start with Streamable HTTP transport
mcp-maintainer-toolkit streamableHttp

Programmatic Usage

import { createServer } from 'mcp-maintainer-toolkit';

const { server, cleanup } = createServer();
// Use the server with your preferred transport

NPM Scripts

If installed locally, you can use the npm scripts:

# Build the project
npm run build

# Start development server with watch mode
npm run watch

# Start with different transports
npm run start          # STDIO
npm run start:sse      # SSE on port 3001
npm run start:streamableHttp  # Streamable HTTP on port 3002

Configuration

Environment Variables

  • PORT: Port for SSE and Streamable HTTP servers (default: 3001 for SSE, 3002 for Streamable HTTP)

MCP Client Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "maintainer-toolkit": {
      "command": "mcp-maintainer-toolkit",
      "args": []
    }
  }
}

Development

# Clone the repository
git clone https://github.com/olaservo/mcp-maintainer-toolkit.git
cd mcp-maintainer-toolkit

# Install dependencies
npm install

# Build the project
npm run build

# Start development with watch mode
npm run watch

Links

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Mock MCP Server

    DiscreteTom
    A
    license
    B
    quality
    D
    maintenance
    A mock MCP server for testing MCP client implementations and development workflows. Supports tools, prompts, and resources across multiple transport protocols (stdio, HTTP, SSE).
    1
    MIT

  • Easy MCP Server

    joshwyatt
    A
    license
    Not graded
    quality
    D
    maintenance
    A simple toolkit for creating MCP servers with stdio and SSE transport, auto-validating tools via Pydantic.
    MIT

  • achmadya-dev/mcp-core

    achmadya-dev
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides a shared MCP SDK wrapper for building MCP servers with stdio transport, tool registration, JSON-safe responses, and environment helpers.
    38 npm
    MIT

  • mcp-express-bolierplate

    Pongsapat1035
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables creation of MCP servers with both stdio and HTTP transports, providing CRUD tools, resources, and prompts for user management, along with a CLI client for testing and integration.
    -