McPico - MCP client for the terminal

McPico, or MCPico if you prefer, is a lightweight MCP client for the terminal.

It supports:

• File attachment 🐛
• MCP servers stdio-based ✅
• MCP servers http-based: 🐛
• Anthropic + r2mcp ✅
• Groq + r2mcp: ✅
• LM Studio + r2mcp: ✅
• Multi-MCP ❔ (to test)

Most of the code has been written by AI... and/but it works pretty well. It has been tested on Linux.

Installation

git clone https://github.com/cryptax/mcpico
pip install -r requirements.txt

Configuration

In ~/.config/mcpico/config.json, setup your API keys and URLs:

{
  "current_provider": "anthropic",
  "providers": {
    "anthropic": {
      "api_key": "CENSORED",
      "model": "claude-sonnet-4-20250514",
      "api_url": "https://api.anthropic.com/v1/messages",
      "type": "anthropic"
    },
  ...
}

Get your inspiration from the default configuration in mcpico.py. More info here.

Run it

python3 mcpico.py

Then use /help for various commands.

Demo

Solving a CrackMe with McPico, r2mcp and Anthropic

Basic use of McPico