# f/mcptools

A command-line interface for interacting with MCP (Model Context Protocol) servers using both stdio and HTTP transport.

Repository: https://github.com/f/mcptools
Canonical: https://ross.abutalabs.com/products/mcptools
Language: Go
License: MIT
License Family: permissive
Topics: mcp, mcp-server, modelcontextprotocol
Last push: 2025-12-18T10:20:08+00:00

## Health v2 (maintenance only)
Score: 47/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 57, release rhythm 40, longevity 37
- inputs: {"age_days": 526, "days_push": 258, "days_rel": 485, "gap_med": 0, "n_releases_24m": 34}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1619, forks 126 (observed 2026-08-28T04:05:12.179354+00:00)

## What it is
A Go-based command-line interface for discovering, calling, and managing tools, resources, and prompts exposed by MCP (Model Context Protocol) servers over stdio and HTTP transports. It also includes mock server, proxy, and guard modes for testing and restricting MCP access.

## Use cases
- list tools available on an MCP server from the terminal
- call an MCP tool without launching an LLM app
- create a mock MCP server to test client applications
- proxy MCP requests to shell scripts
- debug MCP server responses in JSON or table format
- scaffold a new TypeScript MCP server project
- restrict which MCP tools an LLM app can access

## When to choose
- you need a scriptable, terminal-first way to inspect and test MCP servers
- you want mock or proxy MCP servers for development and testing
- you prefer a lightweight CLI over a GUI inspector
- you manage MCP configs for LLM apps like Claude or Cursor

## When to avoid
- you need a graphical interface for exploring MCP servers
- you want a full MCP client embedded in your application rather than a CLI
- your workflow is entirely non-terminal based

## Facets
- artifact type: cli-tool
- maturity: active
- function: mcp, cli, developer-tools, mocking, proxy, chatbot
- domain: developer-tools, large-language-models, testing
- platform: windows, cli, cross-platform
- tags: model-context-protocol, mcp-client, mcp-proxy, mock-server, interactive-shell, llm-tools, go, ai-agents, command-line, macos, linux

## Member repositories
- f/mcptools (main) score 47

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:12.179354+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:49:26.367464+00:00, confidence not recorded.
  - readme: https://github.com/f/mcptools (fetched 2026-08-28T04:05:12.179354+00:00, sha 74fd5cf7857e)
- Data as of 2026-08-30T08:39:29.467469+00:00.