mcp-open-client 0.1.8

An open-source client for the Model Context Protocol

MCP Open Client

A NiceGUI-based chat application for Claude and other OpenAI-compatible APIs. Version 0.1.1.

Features

• Chat interface for Claude and other OpenAI-compatible APIs
• Support for custom tools and function calling
• Conversation management
• Settings customization
• Dark mode support

Installation

You can install the latest version of the package from PyPI:

pip install mcp-open-client

To install a specific version:

pip install mcp-open-client==0.1.1

Or install the latest development version directly from GitHub:

pip install git+https://github.com/alejoair/mcp-open-client.git

For development installation:

# Clone the repository
git clone https://github.com/alejoair/mcp-open-client.git
cd mcp-open-client

# Install in development mode
python install_dev.py

Usage

After installation, you can run the application with:

mcp-open-client [--port PORT] [--host HOST]

Command-line options:

• --port PORT: Specify the port to run the application on (default: 8081)
• --host HOST: Specify the host to run the application on (default: 0.0.0.0)

Or from Python:

from mcp_open_client.main import main

if __name__ == "__main__":
    main(port=8081, host="0.0.0.0")

Configuration

The application stores its configuration in the user's home directory at ~/mcp-open-client/config/. The following files are created:

• user_settings.json: Contains user settings like API key, model, etc.
• user_tools.json: Contains custom tools created by the user
• user_theme.css: Contains the user's custom CSS theme (created on first installation)

Theme Customization

During the first installation, the default theme CSS file is copied to your configuration directory. You can customize the application's appearance by editing the user_theme.css file located at ~/mcp-open-client/config/user_theme.css.

API Configuration

To use the application, you need to configure your API key in the settings. The application supports:

• OpenAI API (ChatGPT, GPT-4)
• Anthropic API (Claude)
• Any OpenAI-compatible API endpoint

Package Structure

mcp_open_client/
├── __init__.py           # Package initialization with version info
├── main.py               # Main entry point
├── api.py                # API client implementation
├── state.py              # Application state management
├── ui/                   # UI components
│   ├── __init__.py       # UI package initialization
│   ├── common.py         # Common UI elements
│   ├── chat.py           # Chat interface
│   ├── settings.py       # Settings interface
│   └── tools.py          # Tools interface
├── assets/               # Static assets
│   └── favicon           # Application favicon
└── settings/             # Default settings
    ├── default_settings.json  # Default application settings
    └── default_tools.json     # Default tools configuration

Development

To set up the development environment:

1. Clone the repository: git clone https://github.com/alejoair/mcp-open-client.git
2. Navigate to the project directory: cd mcp-open-client
3. Install in development mode: python install_dev.py
4. Run the application: python -m mcp_open_client.main

Testing

To verify the package installation:

python test_import.py

API Reference

Main Module

from mcp_open_client.main import main

# Run the application with custom settings
main(port=8080, host="127.0.0.1")

State Module

from mcp_open_client.state import State

# Access the application state
state = State()

API Module

from mcp_open_client.api import ChatAPI

# Create a chat API instance
api = ChatAPI()

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.