# 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`](../../tree/chore/migrate-mcp-sdk-v2) branch and in [PR #58](../../pull/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

```bash
npm install -g mcp-maintainer-toolkit
```

Or install locally:

```bash
npm install mcp-maintainer-toolkit
```

## Usage

### Command Line

After global installation, you can run the server directly:

```bash
# 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

```javascript
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:

```bash
# 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:

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

## Development

```bash
# 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](https://github.com/olaservo/mcp-maintainer-toolkit)
- [npm Package](https://www.npmjs.com/package/mcp-maintainer-toolkit)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [Author's Website](https://www.olahungerford.com)