mcp-cli-catalog

An MCP server that publishes the CLI tools on your machine. Coding agents already have shell access and are great at generating complex commands with pipes and filters. This just tells them what's available so they can use MCP tools more efficiently.

- LLM coding agents can effectively chain shell commands with pipes to filter and reshape complex data.
- Declaring CLI tools as MCP tools makes them discoverable to the LLM.

- This server exposes your CLI tools as MCP tool definitions so the LLM knows what's available.
- The MCP tools defined in the catalog only instruct the LLM to use the shell; they do not execute any tools themselves.
- Shell access is required for the agent to actually run the commands.

Add the server to your MCP config (e.g. for Claude Code):

{ "mcpServers": { "cli-catalog": { "command": "npx", "args": ["mcp-cli-catalog"] } } }

{ "mcpServers": { "cli-catalog": { "command": "npx", "args": ["mcp-cli-catalog", "--config", "./tools.json"] } } }

Add a JSON catalog file (default:~/.mcp-cli-catalog.json) with the CLI tools you want to make discoverable:

{ // JSON Comments are allowed. "tools": [ { "name": "knowledge-base-search", "description": "Search full text across the knowledge base", "usage": "knowledge-base-search 'pattern' | head" }, { "name": "knowledge-base-get", "description": "Get a knowledge base file", "usage": "knowledge-base-get path/to/file.md | sed -n '100,200p'\nknowledge-base-get path/to/file.md | rg 'TODO'" } ] }

- nameanddescriptionare required.
- usage(optional) shows up as a hint in responses.
- command(optional) is the exact string to run. If you skip it, the toolnameis used.
- Point to a different catalog with--config <path>orMCP_CLI_CATALOG_FILE=<path>.

Test your server setup with the MCP Inspector:

npx @modelcontextprotocol/inspector npx mcp-cli-catalog

npx @modelcontextprotocol/inspector npx mcp-cli-catalog --config ./tools.json

- npm run dev: run directly fromsrc/index.js
- npm run build: compile todist/index.jsand fix permissions
- npm start: run the built server fromdist/index.js

Cloudflare’s “Code Mode”1and Anthropic’s code‑execution‑with‑MCP post2explore a different way to solve MCP tooling challenges. Their approach provides MCP tools through an SDK to the LLM, which writes code to call and process those tools. This project takes a simpler path: build CLI tools and make them discoverable through the MCP tool catalog.
- Cloudflare, “Code Mode,” 2025.
- Anthropic, “Code execution with MCP,” 2025.

Real-time stock heatmaps and investment tools delivered as interactive React components.