mcptools

<p align="center"> <img src="./.github/resources/logo.png" alt="MCP Tools" height="150"> </p> <p align="center"> <h1 align="center">Swiss Army Knife for MCP Servers</h1> <p align="center"> A comprehensive command-line interface for interacting with MCP (Model Context Protocol) servers. <br> Discover, call, and manage tools, resources, and prompts from any MCP-compatible server. <br> Supports multiple transport methods, output formats, and includes powerful mock and proxy server capabilities. </p> </p>

Table of Contents

• Overview
• Difference Between the MCP Inspector and MCP Tools
• Installation
  • Using Homebrew
  • From Source
• Getting Started
• Features
  • Transport Options
  • Output Formats
  • Commands
  • Interactive Shell
  • Web Interface
  • Project Scaffolding
• Server Aliases
• LLM Apps Config Management
• Server Modes
  • Mock Server Mode
  • Proxy Mode
  • Guard Mode
• Examples
  • Basic Usage
  • Script Integration
  • Debugging
• Contributing
• Roadmap
• License

Overview

MCP Tools provides a versatile CLI for working with Model Context Protocol (MCP) servers. It enables you to:

• Discover and call tools provided by MCP servers
• Access and utilize resources exposed by MCP servers
• Create mock servers for testing client applications
• Proxy MCP requests to shell scripts for easy extensibility
• Create interactive shells for exploring and using MCP servers
• Scaffold new MCP projects with TypeScript support
• Format output in various styles (JSON, pretty-printed, table)
• Guard and restrict access to specific tools and resources
• Support all transport methods (HTTP, stdio)

<p align="center"> <img src=".github/resources/screenshot.png" alt="MCP Tools Screenshot" width="700"> </p>

Installation

Using Homebrew (for macOS)

brew tap f/mcptools
brew install mcp

❕ The binary is installed as mcp but can also be accessed as mcpt to avoid conflicts with other tools that might use the mcp command name.

From Source (for Windows and GNU/Linux)

go install github.com/f/mcptools/cmd/mcptools@latest

❕ The binary will be installed as mcptools when but can be aliased to mcpt for convenience.

<img width="500" alt="Screenshot 2025-05-05 at 22 21 29" src="https://github.com/user-attachments/assets/eaba...