mcp-builder

Scaffold, test, and package Model Context Protocol servers for multiple AI platforms.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/tanujkumar38/unified-mcp-gateway --skill mcp-builder-tanujkumar38
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/tanujkumar38/unified-mcp-gateway/tree/main/.agents/skills/mcp-builder
Command: npx skills add https://github.com/tanujkumar38/unified-mcp-gateway --skill mcp-builder-tanujkumar38

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building a Model Context Protocol (MCP) server that works across Claude Desktop, ChatGPT, Cursor, and other AI hosts requires navigating platform-specific transport rules, JSON-RPC handshake requirements, and context window limits, which this Skill codifies into a repeatable engineering workflow. ## Core Features & Use Cases - Automated Scaffolding: Generate complete MCP server projects via scripts/mcp_scaffold.py with archetypes for universal dual-transport servers, multi-server gateways, TypeScript stdio/HTTP, Python FastMCP, private-API portals, and Puppeteer browser automation. - Protocol Verification: Run scripts/verify_mcp_server.py to test the initialize handshake, ping, tool discovery, and detect stdout pollution that corrupts stdio JSON-RPC streams. - Platform Compatibility Guidance: Reference playbooks cover ChatGPT's HTTPS-only and tools-only constraints, readOnlyHint requirements, search/fetch connector tools, and the 4-tool Meta-Tool gateway pattern that cuts context usage by roughly 97%. - Use Case: Connect an internal enterprise portal with no public API to Claude Desktop by scaffolding a private-api server, implementing session re-authentication, verifying the protocol handshake, and registering the host configuration. ## Quick Start Ask the agent to scaffold a universal MCP server for your target service and verify it with the protocol tester.

Frequently Asked Questions about mcp-builder

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

FAQPage Schema
How do I build an MCP server for Claude Desktop?

Scaffold a TypeScript stdio server with mcp_scaffold.py using --type ts-stdio, then run npm install and npm run build. Register it in claude_desktop_config.json with an absolute path to build/index.js and any required environment variables.

How to connect an MCP server to ChatGPT?

ChatGPT only supports remote HTTPS SSE transports, never local stdio. Run the server in HTTP mode, expose it through ngrok or Cloudflare Tunnel, and register the public /sse URL in ChatGPT Developer Mode.

Why does my MCP server fail with JSON parsing errors?

The most common cause is stdout pollution: any console.log or print writing to stdout corrupts the JSON-RPC stream in stdio mode. Route all diagnostic logging to stderr and verify with the MCP Inspector or a raw pipe handshake test.

Does ChatGPT support MCP resources and prompts?

No, ChatGPT implements a tools-only subset of MCP and ignores resources, prompts, roots, and sampling. Wrap each resource and prompt as a callable fallback tool, and set readOnlyHint: true on read tools to avoid manual approval prompts.

How do I reduce context window usage with many MCP tools?

Use the Meta-Tool gateway pattern, which exposes only four tools (list_plugins, search_tools, get_tool_schema, call_tool) instead of loading every schema. This reduces context consumption from tens of thousands of tokens to roughly 1,200.

How can I build an MCP server for a website without an API?

Choose between three archetypes: web scraping with Axios and Cheerio for public read-only content, Puppeteer browser automation for JavaScript-heavy interactive sites, or private-API reverse engineering of internal XHR endpoints for authenticated portals.