Engineering
mcp-client avatar

mcp-client

Universal MCP client for connecting to any MCP server with progressive disclosure. Wraps MCP servers as skills to prevent context window bloat from tool definitions. Use for Zapier, GitHub, sequential thinking, and file operations.

Introduction

The mcp-client skill transforms Claude Code into a powerful interface for the Model Context Protocol (MCP), allowing you to interact with diverse external services without overwhelming your context window. By implementing progressive disclosure, this skill only loads tool schemas when specifically requested, maintaining high performance and efficiency during complex multi-step workflows. It is designed for developers, system integrators, and power users who need to connect Claude to professional tools like Zapier, GitHub, or local services like Sequential Thinking.

  • Enables seamless connection to any MCP server using various transports, including stdio, SSE, and Streamable HTTP.

  • Features on-demand tool schema loading, which prevents thousands of tokens from being dumped into your context window upfront.

  • Provides a unified command interface for listing configured servers, retrieving specific tool schemas, and executing tool calls with precise arguments.

  • Supports standard authentication methods for remote servers, including Bearer tokens for services like Zapier.

  • Simplifies the management of server configurations by supporting multiple locations including custom paths, local .mcp.json files, and ~/.claude.json.

  • Ensure you have the required Python dependencies installed, specifically the mcp and fastmcp libraries.

  • Always test newly connected servers by listing tools and executing sample calls to verify schema validity.

  • Document tool-specific behaviors, quirks, or undocumented parameter requirements in your project's CLAUDE.md file to save context in future sessions.

  • When working with local servers, ensure that the path to your command (e.g., npx or a specific python script) is correctly configured in your references/mcp-config.json file.

  • Pay close attention to transport detection: use URL and API keys for remote FastMCP servers, and command/args arrays for local stdio-based servers.

Repository Stats

Stars
709
Forks
202
Open Issues
1
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 04:59 AM
View on GitHub