llm-mcp-cli

# llm-mcp-cli A comprehensive LLM CLI plugin for Model Context Protocol (MCP) integration, enabling seamless interaction between the LLM command-line tool and MCP servers. ## Table of Contents - [Installation](#installation) - [Quick Start](#quick-start) - [Commands Reference](#commands-reference) - [Server Management](#server-management) - [Tool Commands](#tool-commands) - [Usage Examples](#usage-examples) - [Common Workflows](#common-workflows) - [Configuration](#configuration) - [Troubleshooting](#troubleshooting) ## Installation ```bash pip install llm-mcp-cli ``` ### Requirements - Python 3.11 or higher - llm >= 0.27.0 - MCP-compatible servers (e.g., `@modelcontextprotocol/server-filesystem`) ## Quick Start 1. **Add an MCP server:** ```bash llm mcp add filesystem npx @modelcontextprotocol/server-filesystem /path/to/directory ``` 2. **List available tools:** ```bash llm mcp tools --format list ``` 3. **Use tools in LLM conversations:** ```bash llm -m gpt-4 "List all files in my directory" $(llm mcp tools --format commands) ``` if you want to add specific server commands ```bash llm -m gpt-4 "List all files in my directory" $(llm mcp tools --server fetch --format commands) ``` ## Commands Reference ### Server Management #### `llm mcp add` Register a new MCP server. **Syntax:** ```bash llm mcp add <name> <command> [args...] [options] ``` **Parameters:** - `name` (required) - Unique identifier for the server - `command` (required) - Command to execute the server (e.g., `npx`, `python`) - `args` (optional) - Additional arguments for the server command **Options:** - `--env KEY=value` - Set environment variables (can be used multiple times) - `--description` - Add a description for the server **Examples:** ```bash # Add filesystem server llm mcp add filesystem npx @modelcontextprotocol/server-filesystem /Users/docs # First store your GitHub token (one-time setup) llm keys set GITHUB_PERSONAL_ACCESS_TOKEN # Add GitHub server (API key automati…