This repository contains a protocol-level CLI designed to interact with a Model Context Provider server. The client allows users to send commands, query data, and interact with various resources provided by the server.
- Protocol-level communication with the Model Context Provider.
- Dynamic tool and resource exploration.
- Support for multiple providers and models:
- Providers: OpenAI, Ollama.
- Default models:
gpt-4o-minifor OpenAI,qwen2.5-coderfor Ollama.
- Python 3.8 or higher.
- Required dependencies (see Installation).
- uv (install using
brew install uvx).
- Clone the repository:
git clone https://github.com/chrishayuk/mcp-cli cd mcp-cli
- Install dependencies:
pip install -r requirements.txt
To start the client and interact with the SQLite server, run the following command:
uv run main.py --server sqlite
--server: Specifies the server configuration to use. Required.--config-file: (Optional) Path to the JSON configuration file. Defaults 63D2 toserver_config.json.--provider: (Optional) Specifies the provider to use (openaiorollama). Defaults toopenai.--model: (Optional) Specifies the model to use. Defaults depend on the provider:gpt-4o-minifor OpenAI.llama3.2for Ollama.
Run the client with the default OpenAI provider and model:
uv run main.py --server sqlite
Run the client with a specific configuration and Ollama provider:
uv run main.py --server sqlite --provider ollama --model llama3.2
The client supports interactive mode, allowing you to execute commands dynamically. Type help for a list of available commands or quit to exit the program.
ping: Check if the server is responsive.list-tools: Display available tools.list-resources: Display available resources.list-prompts: Display available prompts.chat: Enter interactive chat mode.clear: Clear the terminal screen.help: Show a list of supported commands.quit/exit: Exit the client.
To enter chat mode and interact with the server:
uv run main.py --server sqlite
In chat mode, you can use tools and query the server interactively. The provider and model used are specified during startup and displayed as follows:
Entering chat mode using provider 'ollama' and model 'llama3.2'...
Contributions are welcome! Please open an issue or submit a pull request with your proposed changes.
This project is licensed under the MIT License.