Skip to main content
Glama
mcp-maintainer-toolkit

mcp-maintainer-toolkit

by olaservo

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: achmadya-dev/mcp-core

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides a shared MCP SDK wrapper for building MCP servers with stdio transport, tool registration, JSON-safe responses, and environment helpers.
      39 npm
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables exposing custom tools such as dice rolling and integer addition as MCP servers over stdio and HTTP transports.
      2
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI tools to uniformly discover, inspect, and call tools, prompts, and resources from multiple upstream MCP servers through a small set of fixed MCP tools, over stdio or HTTP.
      2
      MIT