A comprehensive command-line interface for interacting with Model Context Protocol (MCP) servers, mcptools allows users to discover, call, and manage tools, resources, and prompts. It targets developers and researchers working with LLM applications and AI agents, offering enhanced control, testing capabilities, and extensibility through various transport methods and server modes.

How It Works

mcptools leverages the Model Context Protocol (MCP) for communication, supporting both stdio and HTTP/SSE transports. It acts as a versatile client, enabling direct interaction with MCP servers, creating mock servers for isolated testing, and proxying requests to shell scripts for custom tool integration. Its unique features include a guard mode for access control and a project scaffolding tool for rapid MCP application development.

Quick Start & Requirements

• Installation:
  • Homebrew: brew tap f/mcptools && brew install mcp
  • From Source: go install github.com/f/mcptools/cmd/mcptools@latest
• Prerequisites: Go (for source install), Homebrew (for binary install).
• Getting Started: Connect to an MCP server and list tools: mcp tools npx -y @modelcontextprotocol/server-filesystem ~
• Documentation: Overview, Features

Highlighted Details

• Supports stdio and HTTP/SSE transport protocols for MCP communication.
• Offers interactive shell, web interface, mock server, and proxy server modes.
• Includes project scaffolding for new MCP applications with TypeScript support.
• Features a "guard mode" to restrict tool/resource access via pattern matching.
• Provides configuration management for integrating MCP servers into applications like VS Code.

Maintenance & Community

• The project is actively maintained by Fatih Taskiran.
• Contributions are welcomed via pull requests.
• Logging is available for mock and proxy servers.

Licensing & Compatibility

• MIT License.
• Permissive license suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

• Configuration management ( mcp configs ) currently only works on macOS.
• Guard mode currently only supports STDIO transport, not HTTP.