Skip to content

olaservo/mcp-maintainer-toolkit

Repository files navigation

MCP Maintainer Toolkit

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

About

MCP Server with utilities to help with maintaining MCP repos

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •