mcp-context-optimizer

Community

Reduce MCP context bloat with progressive loading

AuthorShunsukeHayashi
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Optimize MCP tool context loading through progressive disclosure and hierarchical indexing. When working with large MCP tool sets (for example Miyabi's 172 tools across 22 categories), this Skill prevents context window bloat by loading only the necessary level of detail at the right time. It triggers on intents like "find tool", "search mcp", "tool lookup", "which tool", "context optimization", or when dealing with many MCP tools.

Core Features & Use Cases

  • Progressive Disclosure Pattern: Level 1 Category Index (Always loaded), Level 2 Tool Index (On-Demand), Level 3 Full Tool Schema (On-Demand)
  • Quick Reference: Provides category breakdown and typical use cases to speed up discovery
  • Workflow Guidance: Use a clear protocol for discovering, filtering, and loading tool details to minimize token usage

Quick Start

Use commands to discover tools and load details as needed:

  • List all categories: miyabi:mcp_list_categories()
  • Search tools by category: miyabi:mcp_search_tools({ category: "docker", query: "logs" })
  • Get full tool info: miyabi:mcp_get_tool_info({ tool: "docker_logs" })

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: mcp-context-optimizer
Download link: https://github.com/ShunsukeHayashi/Miyabi/archive/main.zip#mcp-context-optimizer

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.