explaingit

aaglexx/mcp-man

★ 17TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A local web UI and CLI for browsing, inspecting, and live-testing MCP servers -- the tools that connect AI assistants like Claude to databases, file systems, and APIs. Covers a registry of 156 servers with an auth setup wizard for 78 of them.

Mindmap

mindmap
  root((mcp-man))
    What it does
      Browse MCP servers
      Inspect tool schemas
      Call tools live
    Features
      156 server registry
      Auth wizard 78 servers
      CLI and web UI
    Usage
      npm install
      mcp-man ui command
      JSON arguments
    Contributing
      Edit registry JSON
      Add env array
      Open pull request
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Browse a registry of 156 MCP servers, inspect every tool's full input schema and parameter types, and call tools live with JSON arguments before wiring anything into an AI assistant.

USE CASE 2

Use the auth wizard to get API keys and credentials for 78 MCP servers, with direct links to each provider's token page.

USE CASE 3

Search MCP server tools and call them from the command line to quickly verify a server works without opening the web UI.

USE CASE 4

Add a new MCP server to the shared registry by editing a JSON file and opening a pull request, including an env array so the auth wizard picks up any required credentials.

Tech stack

TypeScriptNode.jsnpm

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

MCP (Model Context Protocol) is the standard way for AI assistants like Claude to connect to external tools, such as database clients, file systems, web search, and GitHub integrations. Each tool provider runs an MCP server, and there are hundreds of them available. The problem is that figuring out what any given server does, what parameters its tools accept, and what credentials it needs typically requires digging through GitHub READMEs and guessing. mcp-man is a browser-based UI and command-line tool that solves this. Install it with npm, run mcp-man ui, and you get a local web interface with a registry of 156 MCP servers you can search by name or tag. Pick one, paste in the startup command, and mcp-man connects to it and shows you every tool it exposes, the full input schema for each tool, required parameters, and types. From the same UI you can call any tool live with JSON arguments and see the raw response, without needing to wire the server into an AI assistant first. For servers that need API keys or other credentials, mcp-man includes an auth wizard that covers 78 servers and provides direct links to get each required token. Everything in the UI is also available from the command line. You can search for servers, inspect a server's tools, and call a specific tool all from the terminal. The project is open to adding new servers: edit the registry JSON file and open a pull request. If a server requires credentials, add an env array and the auth wizard picks it up automatically. The project is MIT licensed and written in TypeScript.

Copy-paste prompts

Prompt 1
I want to use mcp-man to test the GitHub MCP server before adding it to Claude. Walk me through installing mcp-man, finding the GitHub server in the registry, entering its startup command, and making a live test call from the UI.
Prompt 2
I built my own MCP server and want to test it with mcp-man before publishing. How do I point mcp-man at a local server that is not in the registry yet?
Prompt 3
I want to add a new MCP server to the mcp-man registry that requires an API key. What format does the registry JSON file use, and how do I add an env array so the auth wizard shows the credential step?
Prompt 4
I want to call an MCP server tool from the command line using mcp-man instead of the web UI. What commands do I run to search for a server, list its tools, and call a specific tool with arguments?
Open on GitHub → Explain another repo

← aaglexx on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.