Skip to main content
Glama

MCP-Ables

by mfakbar127
GitHub
Python
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP-Ables

Turn any shell command into MCP Server

Why bother coding long MCP servers for every need, when you can just provide shell commands?

What is MCP-Ables?

MCP-Ables bridges the gap between command-line tools and AI agents like Claude Code. Write a tiny YAML file describing your shell command, and MCP-Ables automatically generates an MCP (Model Context Protocol) server that AI agents can call.

No Python coding. No complex setup. Just YAML → MCP → AI-callable tools.

Quick Start

Prerequisites

  • Python 3.11+

  • The command-line tool you want to expose (e.g., nuclei, ls, etc.)

Installation

git clone https://github.com/mfakbar127/MCP-Ables.git cd mcpables pip install -r requirements.txt

Usage

  1. Create a YAML file describing your tool(s) (see examples below)

  2. Run MCP-Ables with a file or directory:

    # Single file python mcpables-main.py examples/nuclei.yaml # Directory (scans recursively for .yaml/.yml files) python mcpables-main.py examples/

  3. The MCP server 'mcpables' is now running with all your tools!

Claude Desktop Integration

Connect MCP-Ables to Claude Desktop so AI can use your tools directly from chat.

Configuration

  1. Locate Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add MCP-Ables server:

{ "mcpServers": { "mcpables": { "command": "python", "args": [ "/absolute/path/to/mcpables-main.py", "/absolute/path/to/examples/" ] } } }

  1. Restart Claude Desktop - Tools will automatically appear

Configuration Examples

Single file (specific vibe):

{ "mcpServers": { "secops": { "command": "python", "args": ["/path/to/mcpables-main.py", "/path/to/examples/secops-tools.yaml"] } } }

Directory (all tools):

{ "mcpServers": { "mcpables-all": { "command": "python", "args": ["/path/to/mcpables-main.py", "/path/to/examples/"] } } }

Multiple configurations (different vibes):

{ "mcpServers": { "secops": { "command": "python", "args": ["/path/to/mcpables-main.py", "/path/to/examples/secops-tools.yaml"] }, "devops": { "command": "python", "args": ["/path/to/mcpables-main.py", "/path/to/examples/devops-tools.yaml"] }, "netops": { "command": "python", "args": ["/path/to/mcpables-main.py", "/path/to/examples/netops-tools.yaml"] } } }

Verify Connection

After restarting Claude Desktop, you can verify the tools are available:

  • Type a message asking Claude about available tools

  • Tools will appear with names like nuclei_scan, nmap_scan, etc.

  • Claude can now execute commands directly!

Use Cases

🔐 SecOps Vibes

Run security scanners from AI agents:

  • Nuclei - Vulnerability scanning

  • Nmap - Network discovery

  • Subfinder - Subdomain enumeration

  • Amass - Attack surface mapping

🎯 Hacking Vibes

Integrate pentesting tools:

  • SQLMap - SQL injection testing

  • Hydra - Password brute forcing

  • Gobuster - Directory/DNS brute forcing

  • Nikto - Web server scanning

🚀 DevOps Vibes

Automate infrastructure from chat:

  • kubectl - Kubernetes management

  • terraform - Infrastructure as code

  • ansible - Configuration management

  • helm - K8s package management

🖥️ SysAdmin Vibes

Server management via AI:

  • systemctl - Service control

  • docker - Container operations

  • journalctl - Log viewing

  • iptables - Firewall rules

🌐 NetOps Vibes

Network diagnostics:

  • ping - Connectivity testing

  • traceroute - Path tracing

  • dig - DNS queries

  • whois - Domain info

📊 Data Vibes

CLI data processing:

  • jq - JSON processing

  • curl - HTTP requests

  • grep/awk - Text processing

  • ffmpeg - Media conversion

YAML Schema

See examples/

Single-Tool Format

name: <tool_name> description: <brief description for AI agents> run: kind: shell cmd: "command {{arg1}} {{arg2}}" args: arg1: type: string|int|float|bool description: "What this argument does" required: true|false default: <optional default value>

Multi-Tool Format

Define multiple tools in one YAML file:

tools: - name: tool1 description: First tool description run: kind: shell cmd: "command1 {{arg1}}" args: arg1: type: string description: "Argument description" required: true - name: tool2 description: Second tool description run: kind: shell cmd: "command2 {{arg2}}" args: arg2: type: int description: "Argument description" required: false default: 10

Argument Fields

  • type: Data type (string, int, float, bool)

  • description: Human-readable explanation for AI agents to understand usage

  • required: Whether the argument must be provided (true or false)

  • default: Default value if not provided (only for optional arguments)

Examples

Simple Echo

examples/echo.yaml:

name: echo_message description: Echo a message to stdout (simple test tool) run: kind: shell cmd: "echo {{message}}" args: message: type: string description: "Message to echo" required: true

Run it:

python mcpables-main.py examples/echo.yaml

Nuclei Scanner

examples/nuclei.yaml:

name: nuclei_scan description: Run Nuclei vulnerability scanner against a target URL or IP address run: kind: shell cmd: "nuclei -c {{concurrency}} -t {{target}} -t {{template_path}}" args: target: type: string description: "Target URL or IP address to scan (e.g., https://example.com)" required: true template_path: type: string description: "Path to Nuclei templates directory (e.g., ~/nuclei-templates/)" required: true concurrency: type: int description: "Number of concurrent requests (1-100)" required: false default: 10

Multi-Tool Example

examples/security-tools.yaml:

tools: - name: nmap_scan description: Run Nmap network scanner against a target run: kind: shell cmd: "nmap {{scan_type}} {{target}}" args: target: type: string description: "Target IP or hostname" required: true scan_type: type: string description: "Scan type flag (e.g., -sV)" required: false default: "-sV" - name: whois_lookup description: Perform WHOIS lookup for a domain run: kind: shell cmd: "whois {{domain}}" args: domain: type: string description: "Domain name to lookup" required: true - name: dig_dns description: DNS lookup using dig command run: kind: shell cmd: "dig {{record_type}} {{domain}}" args: domain: type: string description: "Domain name to query" required: true record_type: type: string description: "DNS record type (A, MX, TXT, etc.)" required: false default: "A"

Run it:

python mcpables-main.py examples/security-tools.yaml # Loads 3 tools: nmap_scan, whois_lookup, dig_dns

Directory Example

Organize tools in separate files:

examples/tools/ ├── ping.yaml (ping_host tool) ├── curl.yaml (http_request tool) └── ...

Run all tools from directory:

python mcpables-main.py examples/tools/ # Recursively loads all .yaml/.yml files

Roadmap

Phase 1 (Completed):

  • ✓ YAML → MCP conversion

  • ✓ Shell command execution

  • ✓ Argument validation and defaults

  • ✓ Rich descriptions for AI agents

  • ✓ Multi-tool YAML support

  • ✓ Directory scanning for YAML files

Phase 2 (Future):

  • Sandboxing and isolation

  • Resource limits (CPU, memory, timeout)

  • Audit logging

  • HTTP request support

  • Multi-command workflows

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Turns any shell command into an MCP server by defining command-line tools in simple YAML files. Enables AI agents to execute system commands, security scanners, DevOps tools, and CLI utilities directly from chat interfaces.

  1. What is MCP-Ables?
    1. Quick Start
      1. Prerequisites
      2. Installation
      3. Usage
    2. Claude Desktop Integration
      1. Configuration
      2. Configuration Examples
      3. Verify Connection
    3. Use Cases
      1. 🔐 SecOps Vibes
      2. 🎯 Hacking Vibes
      3. 🚀 DevOps Vibes
      4. 🖥️ SysAdmin Vibes
      5. 🌐 NetOps Vibes
      6. 📊 Data Vibes
    4. YAML Schema
      1. Single-Tool Format
      2. Multi-Tool Format
      3. Argument Fields
    5. Examples
      1. Simple Echo
      2. Nuclei Scanner
      3. Multi-Tool Example
      4. Directory Example
    6. Roadmap

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/mfakbar127/MCP-Ables'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server