mcp-light-generator

Generate a FastMCP proxy server with compressed MCP tool descriptions.

56|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/nyosegawa/skills --skill mcp-light-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-light-generator
Source: https://github.com/nyosegawa/skills/tree/main/skills/mcp-light-generator
Command: npx skills add https://github.com/nyosegawa/skills --skill mcp-light-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill tackles the issue of overly verbose tool descriptions in MCP servers, which consume excessive tokens and slow down AI processing. It streamlines these descriptions to improve efficiency.

Core Features & Use Cases

  • Description Compression: Analyzes existing MCP tool descriptions and separates them into a concise 1-line summary for immediate use and detailed best practices for later reference.
  • Lightweight Server Generation: Creates a "Light" version of an MCP server (FastMCP proxy) with the compressed descriptions.
  • Best Practice Skill Creation: Generates a separate Skill containing the detailed usage guidelines and best practices extracted from the original descriptions.
  • Use Case: When interacting with a large MCP server like @notionhq/notion-mcp-server, this Skill can generate a lighter version that uses significantly fewer tokens for tool selection, while still providing access to the full operational details through a dedicated best-practices skill.

Quick Start

Use the mcp-light-generator skill to create a light version of the notionhq/notion-mcp-server.

Frequently Asked Questions about mcp-light-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce token usage for large MCP server tool descriptions?

To reduce MCP token usage, you can compress verbose tool descriptions into concise 1-line summaries. This separates essential decision-making information from detailed operational best practices, significantly shrinking the AI model's context window consumption.

How does compressing MCP descriptions affect AI processing speed?

Compressing MCP descriptions streamlines AI processing by replacing overly verbose text with lightweight summaries. The AI reads fewer tokens during tool selection, which speeds up response times while still retaining full operational details in a separate skill.

What is the best way to generate a FastMCP proxy server from an existing MCP server?

The best way to generate a FastMCP proxy is by separating essential tool summaries from detailed best practices. This creates a lightweight server with condensed descriptions for immediate tool selection, alongside a companion Agent Skill for detailed usage guidance.

Can I still access detailed usage guidelines after compressing MCP tool descriptions?

Yes, you can still access detailed usage guidelines after compression. The process extracts verbose best practices from the original descriptions and generates a separate companion Agent Skill, ensuring full operational details remain available when needed.

Does compressing MCP tool descriptions work with complex servers like the Notion MCP server?

Yes, description compression works with complex servers like the Notion MCP server. It generates a lighter FastMCP proxy version that uses significantly fewer tokens for tool selection, while still providing access to full operational details through a dedicated best-practices skill.

When should I compress MCP server tool descriptions?

You should compress MCP server tool descriptions when overly verbose text consumes excessive tokens and slows down AI processing. If your model's context window is being overwhelmed by large MCP servers, this compression improves efficiency.