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-mini
for OpenAI,qwen2.5-coder
for Ollama.
- Python 3.8 or higher.
- Required dependencies (see Installation)
- Clone the repository:
git clone https://github.com/chrishayuk/mcp-cli
cd mcp-cli
- Install UV:
pip install uv
- Resynchronize dependencies:
uv sync --reinstall
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 toserver_config.json
.--provider
: (Optional) Specifies the provider to use (openai
orollama
). Defaults toopenai
.--model
: (Optional) Specifies the model to use. Defaults depend on the provider:gpt-4o-mini
for OpenAI.llama3.2
for 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'...
If you wish to use openai models, you should
- set the
OPENAI_API_KEY
environment variable before running the client, either in .env or as an environment variable.
Contributions are welcome! Please open an issue or submit a pull request with your proposed changes.
This project is licensed under the MIT License.