MCP-Client-Server-with-LLM-Command-Execution
3.1
If you are the rightful owner of MCP-Client-Server-with-LLM-Command-Execution and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Machine Command Processor (MCP) is a client-server system that uses LLMs to convert natural language queries into shell commands.
Machine Command Processor (MCP)
A client-server system that uses LLMs to convert natural language queries into shell commands. The system consists of three main components: a client that processes natural language queries through Groq's LLM API, a server that executes shell commands, and a shared protocol for communication.
Features
- Natural language to shell command conversion using Groq's LLM API
- WebSocket-based client-server communication
- Command execution safety checks
- Comprehensive logging system
- Asynchronous operation using Python's asyncio
- Structured message protocol with UUID tracking
Prerequisites
- Python 3.7+
- Groq API key
- WebSocket support
- Required Python packages:
- websockets
- groq
- asyncio
- logging
Installation
- Clone the repository
- Install required packages:
pip install websockets groq
- Set up your Groq API key:
export GROQ_API_KEY='your-api-key'
Components
MCP Client (mcp_client.py)
- Handles user input
- Connects to Groq API for command generation
- Communicates with server via WebSocket
- Processes and displays results
MCP Server (mcp_server.py)
- Executes shell commands
- Implements command safety checks
- Manages WebSocket connections
- Returns command execution results
Protocol (mcp_protocol.py)
- Defines message structure
- Handles message serialization/deserialization
- Provides message creation utilities
Usage
- Start the server:
python mcp_server.py
- In a separate terminal, start the client:
python mcp_client.py
- Enter natural language queries when prompted. For example:
Enter your query: list all files in the current directory
Security Features
- Blocked dangerous commands including:
- sudo
- rm -rf
- mkfs
- dd
- format
- Command validation before execution
- Logged operations for audit trails
Logging
The system maintains two log files:
mcp_client.log: Client-side operations and LLM interactionsmcp_server.log: Server-side operations and command execution
Contributing
[Add contribution guidelines here]
