whatisgithub

What is mcptools?

f/mcptools — explained in plain English

Analysis updated 2026-05-18

1,590GoAudience · developerComplexity · 2/5Setup · easy

In one sentence

A command-line tool for exploring, testing, and managing MCP servers, the standard that lets AI tools talk to external services, without writing code.

Mindmap

mindmap
  root((MCP Tools))
    What it does
      CLI for MCP servers
      Explore and test servers
    Tech stack
      Go
      MCP
    Use cases
      List server tools
      Mock a server
      Proxy shell scripts
    Features
      Guard mode
      Web interface
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

List and call the tools an MCP server exposes from the command line.

USE CASE 2

Mock an MCP server to test a client application before it's ready.

USE CASE 3

Wrap ordinary shell scripts as MCP tools using proxy mode.

USE CASE 4

Restrict which tools an MCP server exposes using guard mode's allow and block lists.

What is it built with?

GoMCP

How does it compare?

f/mcptoolsdevenjarvis/lathenvidia/aistore
Stars1,5901,5601,864
LanguageGoGoGo
Last pushed2026-06-27
MaintenanceActive
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
No license information was found in the material provided.

So what is it?

MCP Tools is a command-line utility for working with MCP servers. MCP stands for Model Context Protocol, which is a standard that lets AI tools communicate with external services, like file systems, databases, or custom scripts. This tool gives you a way to explore, test, and interact with any server that follows that protocol, without needing to write code. From the command line you can list what capabilities a server offers, call individual tools by name, read resources, or retrieve prompt templates. There is also an interactive shell mode where you stay connected to a server and run multiple commands in one session, and a web interface that opens in your browser and lets you fill in forms instead of typing JSON by hand. The tool includes a mock server feature, useful when you are building a client application and want to test it against a fake server without setting up the real thing. There is also a proxy mode where you register ordinary shell scripts as MCP tools: the proxy server wraps each script and exposes it over the protocol so an AI client can call it like any other tool. A guard mode lets you restrict what tools a server exposes by allowing or blocking names using wildcard patterns. For example, you could wrap a file system server so that only read operations are visible to the AI, preventing any modifications. The tool also reads configuration files from editors like VS Code, Cursor, and Claude Desktop so you can view and manage all your MCP server settings across different applications in one place. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me how to list the tools available on an MCP server with this CLI.
Prompt 2
Help me wrap a shell script as an MCP tool using proxy mode.
Prompt 3
Explain how guard mode restricts which tools an AI client can call.
Prompt 4
How do I view MCP server configs from VS Code, Cursor, and Claude Desktop in one place?

Frequently asked questions

What is mcptools?

A command-line tool for exploring, testing, and managing MCP servers, the standard that lets AI tools talk to external services, without writing code.

What language is mcptools written in?

Mainly Go. The stack also includes Go, MCP.

What license does mcptools use?

No license information was found in the material provided.

How hard is mcptools to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mcptools for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.