Metadata-Version: 2.4
Name: mcp-client-console
Version: 0.1.0
Summary: MCP client that connects to a remote MCP server
Project-URL: Homepage, https://github.com/geomux/mcp-client-console
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: mcp<2,>=1.25
Requires-Dist: platformdirs>4.0
Description-Content-Type: text/markdown

# mcp-client-console

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

## Remote MCP System Architecture Flowchart

{user} <--> mcp-client-console <--> network <--> {box} <--> mcp-server-remote <--> tools

## mcp-client-console Architecture Flowchart

{user} <--> cli.py <--> client.py <--> mcp SDK <--> * <--> mcp-server-remote

## User Guide | Installation

### Users: install commands
    :~$ pipx install mcp-client-console
    :~$ mcp-client-console
    
### Developers: install commands
    :~$ 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 will create a default config.toml file and print the filepath to the config file.

Navigate to the filepath, edit the config file- populate with server name, url, token. 

*The client reads from "config.toml" to locate and access remote MCP server.*

EXAMPLE:
```
[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

/config command may be used to print filepath within the termianl chat.

    
## User Guide | Operation

Start your MCP server first, see related / requires repos below.

Confirm the MCP client is configured to connect to the remote server location.

*The client connects, performs MCP handshake, lists the available tools via the server.*

Use LLM natural language processing in CLI to access tools on remote box.

EXAMPLE:
```
:~$ mcp-client-console
Connected to Box_1 @ http://127.0.0.1:9000/mcp
___

How may I help you today?

```

## Related / Required Repos

### mcp-server-remote
    https://github.com/geomux/mcp-server-remote

### mcp-gateway-remote
    https://github.com/geomux/mcp-gateway-remote


## --
## Project Status
## --
- [x] Create MCP client repo
- [x] Connect to MCP server locally
- [ ] LLM backend (API / local Ollama) added to client
- [ ] Connect to MCP server remotely with TLS + bearer auth


