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

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

• GitHub Repository
• npm Package
• Model Context Protocol
• Author's Website