MCP Client-Server System

An MCP-based client–server system where a client queries an Ollama-backed server that executes generated system commands and returns output.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hamzabarak-mcp_server_client_assessment": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

This MCP server implements a client–server system where a client queries the server, which uses Ollama to process the request, generate a system command, execute it, and return the resulting output. It leverages FastAPI and the MCP Python SDK to provide a practical, scriptable interface for executing system commands in response to client queries.

How to use

Use this MCP server with a compatible MCP client to send a query and receive command output. The server processes the query using Ollama, constructs an appropriate system command, executes it on the host, and returns the command output to the client. This workflow enables automation of local command execution based on high-level natural-language-like requests, suitable for rapid prototyping, testing, and controlled automation scenarios.

How to install

Prerequisites include specific runtime and tooling needed to run the MCP server and client locally.

cd mcp_server_client_assessment

Install Python dependencies from the repository requirements file.

pip install -r requirements.txt

Start the MCP server as shown in the repository, then run the client to verify end-to-end operation.

python server.py

python client.py

Additional notes

The server uses Ollama for local model execution and the MCP Python SDK for client–server communication. Ensure Ollama is installed and running before starting the server. If you modify environment settings, adjust the runtime environment accordingly and restart the server to apply changes.