mcp-client-console

MCP client that connects to a remote MCP server, LLM backend (API key or local model) and preset configuration files.

Intended for use within private network for Cybersecurity purposes.

System:  {user} <--> mcp-client-console <--> network <--> {box} <--> mcp-server-remote <--> tools
Client:  {user} <--> cli.py <--> client.py <--> mcp SDK <--> * <--> mcp-server-remote

User Guide | LLM Backend Setup

Skip this section if using an API LLM connection. For a local model, set up Ollama before installing the client:

curl -fsSL https://ollama.com/install.sh | sh   # Linux. macOS: brew install ollama. Windows: winget install Ollama.Ollama
ollama pull qwen2.5:14b                         # default model in config_default.toml
ollama list                                     # confirm Ollama is running and the model is pulled

To use a different model, pull it the same way and update model under [llm.local] in your config.toml to match the tag exactly. host under [llm.local] must include the full scheme: http://127.0.0.1:11434... not 127.0.0.1:11434.

User Guide | Installation

Users:

pipx install mcp-client-console
mcp-client-console

Developers:

git clone https://github.com/geomux/mcp-client-console.git
cd mcp-client-console
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-client-console

User Guide | Configuration

First run creates a default config.toml and prints its filepath (the /config command in the terminal chat prints it too). Edit it... populate with server name, url, token:

[server]
name = "Box_1"
url = "http://127.0.0.1:9000/mcp"
OS Config filepath
Linux ~/.config/mcp-client-console/config.toml
macOS ~/Library/Application Support/mcp-client-console/config.toml
Windows %LOCALAPPDATA%\mcp-client-console\config.toml

User Guide | Operation

Start your MCP server first (see repos below) and confirm the client is configured to reach it. The client connects, performs the MCP handshake, and lists the server's tools. Use LLM natural language in the CLI to access tools on the remote box:

$ mcp-client-console
Connected to Box_1 @ http://127.0.0.1:9000/mcp

How may I help you today?

Related / Required Repos

Project Status

  • Create MCP client repo
  • Connect to MCP server locally
  • LLM backend (API / local Ollama) added to client
  • Connect to MCP server remotely (e.g. over the internet)
  • Add TLS + bearer auth as requirement

Project links

Data verified by PyPI on Aug 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for geomux from gravatar.com geomux

GitHub Statistics

Data verified by PyPI on Aug 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_client_console-0.4.3.tar.gz (42.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_client_console-0.4.3-py3-none-any.whl (54.5 kB view details)

Uploaded Python 3

File details

Details for the file mcp_client_console-0.4.3.tar.gz.

File metadata

  • Download URL: mcp_client_console-0.4.3.tar.gz
  • Upload date:
  • Size: 42.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_client_console-0.4.3.tar.gz
Algorithm Hash digest
SHA256 5d10485f31710c0d5966c648b69008d4660b5d98a0bd6169ec64dce8c3e8e7a7
MD5 bad3cee434733520e5f310e57aaa2035
BLAKE2b-256 36e72c54706d6586440677bcda393f88df65d35301cf4e028ef4a5d9817bd1de

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_client_console-0.4.3.tar.gz:

Publisher: publish.yaml on geomux/mcp-client-console

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_client_console-0.4.3-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_client_console-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2d2bea3ee9dd5bea3871c4dfe8c4876aabf366f44889c5b1a70fa9c065049dd7
MD5 3346807797a22b79320867dee97cce1b
BLAKE2b-256 0a87cca38d9ec9a57270214938a9f3f9db1e5f68c89c88e31599cba89d91f33b

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_client_console-0.4.3-py3-none-any.whl:

Publisher: publish.yaml on geomux/mcp-client-console

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page