Modern Cli MCP

🚀 Modern CLI MCP Server

The MCP server exposes 107 modern CLI tools to AI/LLM agents, offering structured JSON - RPC access to various resources and optimized for AI consumption.

🚀 Quick Start

Claude Desktop / Claude Code

Add to your MCP configuration:

Option 1: Nix (Recommended)

{
  "mcpServers": {
    "modern-cli": {
      "command": "nix",
      "args": ["run", "github:NacoSolutions/modern-cli-mcp", "--"]
    }
  }
}

Option 2: Docker

{
  "mcpServers": {
    "modern-cli": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/nacosolutions/modern-cli-mcp"]
    }
  }
}

Option 3: Binary

{
  "mcpServers": {
    "modern-cli": {
      "command": "/path/to/modern-cli-mcp"
    }
  }
}

✨ Features

• 107 Tools in 15 Groups: Covers filesystem, search, Git (GitHub/GitLab), containers, Kubernetes, and data processing.
• AI - Optimized Output: Defaults to JSON for structured parsing.
• Access Control: Uses .agentignore files to control AI agent file access.
• Zero Config: Nix bundles all dependencies, eliminating manual tool installation.

📦 Installation

Nix with Flakes (Recommended)

Flakes are enabled by default in Determinate Nix. For standard Nix, enable with --experimental-features 'nix-command flakes' or add to ~/.config/nix/nix.conf:

experimental-features = nix-command flakes

Run directly (no installation):

nix run github:NacoSolutions/modern-cli-mcp

Install to profile:

nix profile install github:NacoSolutions/modern-cli-mcp

Add to flake.nix:

{
  inputs.modern-cli-mcp.url = "github:NacoSolutions/modern-cli-mcp";

  # Use in outputs
  outputs = { self, nixpkgs, modern-cli-mcp }: {
    # Add to packages, devShells, etc.
  };
}

Nix with FlakeHub

FlakeHub provides versioned flake references with semantic versioning.

Add to flake.nix via CLI:

fh add NacoSolutions/modern-cli-mcp

Or manually:

{
  inputs.modern-cli-mcp.url = "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/*.tar.gz";
}

Run specific version:

nix run "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/0.2.tar.gz"

Nix without Flakes (Classic)

For Nix installations without flakes enabled, the repository includes a default.nix via flake-compat:

Build from tarball:

nix-build https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default
./result/bin/modern-cli-mcp

Or clone and build locally:

git clone https://github.com/NacoSolutions/modern-cli-mcp
cd modern-cli-mcp
nix-build
./result/bin/modern-cli-mcp

Install to profile:

nix-env -if https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default

Docker

docker pull ghcr.io/nacosolutions/modern-cli-mcp
docker run --rm -i ghcr.io/nacosolutions/modern-cli-mcp

From Source (Cargo)

Requires CLI tools to be installed separately in PATH:

cargo install --git https://github.com/NacoSolutions/modern-cli-mcp

💻 Usage Examples

Available Tools (70+)

Filesystem

Search

Git Forges

Containers

Kubernetes

Data Transformation

Network

System

Diff/Git

Utilities

🔧 Technical Details

Architecture

src/
├── main.rs           # Entry point, MCP server setup
└── tools/
    ├── mod.rs        # Tool registration and routing
    └── executor.rs   # Tool execution logic

The server wraps CLI tools with structured JSON input/output. Each tool:

1. Validates parameters via JSON Schema
2. Constructs the appropriate command
3. Executes and captures output
4. Returns structured results

Configuration

The Nix package bundles all CLI tools. When running via cargo, ensure tools are in PATH.

Environment Variables

• RUST_LOG - Logging level (default: info)

.agentignore

Control which files AI agents can access using .agentignore files. Uses gitignore syntax but operates independently—tools respect .agentignore only, not .gitignore.

Pattern sources (in order of precedence):

1. ~/.config/agent/ignore - Global patterns for all projects
2. .agentignore - Per - directory patterns (walked up from working directory)

Example .agentignore:

# Secrets and credentials
*.secret
.env*
secrets/
credentials.json

# Large generated files
node_modules/
target/
*.min.js

# Sensitive data
*.pem
*.key

Behavior:

• Blocked paths return an error: Path is blocked by .agentignore: /path/to/file
• Search tools (fd, rg, ast - grep) automatically apply ignore patterns
• Patterns in child directories extend (not replace) parent patterns

📄 License

This project is licensed under the MIT License.