Plurigrid Juvix MCP Server

🚀 CLI MCP Server

This is a CLI tool for implementing the Model Context Protocol (MCP). It supports a command-line interface, allowing users to run and manage models by specifying configuration parameters.

🚀 Quick Start

This CLI tool simplifies the process of running and managing models through the Model Context Protocol (MCP). You can install and configure it according to the following steps, and then use various commands to interact with the MCP service.

✨ Features

• Command-line Interface: Allows users to run and manage models through simple commands.
• Multiple Installation Methods: Supports installation via pip and from source code.
• Flexible Configuration: Supports configuration through environment variables and configuration files.
• Rich Commands: Provides commands such as listing models, creating sessions, sending requests, and ending sessions.

📦 Installation

Method 1: Install via pip

pip install mcp-cli

Method 2: Install from source code

1. Clone the repository:

git clone https://github.com/yourusername/mcp-cli.git
cd mcp-cli

2. Install dependencies:

uv sync

3. Build and install:

uv build
pip install dist/*

📚 Documentation

Configuration

Environment Variable Configuration

The following are the supported environment variables and their default values:

Configuration File

You can add custom configurations in ~/.config/mcp-cli/config.json:

{
  "api_key": "your_api_key",
  "endpoint": "https://custom.mcp.com",
  "log_level": "DEBUG"
}

Usage Instructions

Basic Commands

1. List all supported models:

mcp-cli list-models

2. Create a new session:

mcp-cli create-session --model_id your_model_id

3. Send a request to the model:

mcp-cli send-request --session_id your_session_id --input "your input text"

4. End the session:

mcp-cli end-session --session_id your_session_id

Advanced Features

1. Use a configuration file to specify parameters:

mcp-cli send-request --config ~/.config/mcp-cli/config.json --input "your input text"

2. Set up a proxy server:

export HTTP_PROXY=http://proxy.example.com:8080
mcp-cli send-request --session_id your_session_id --input "your input text"

Security Precautions

⚠️ Important Note

• Ensure that the MCP_API_KEY is not leaked and avoid storing it in plain text.
• Use HTTPS for communication and SSL verification is enabled by default.
• Regularly update the API key to enhance security.
• Configure the firewall to restrict access to the MCP service endpoint.

Frequently Asked Questions

Question 1: Unable to connect to the MCP service

Solution:

• Check the network connection.
• Confirm that the MCP_ENDPOINT is correct.
• Check the log output for more error information.

Question 2: Request timeout

Solution:

• Increase the COMMAND_TIMEOUT configuration value.
• Check if there is a traffic throttling policy on the server side.
• Ensure sufficient network bandwidth.

Development Guide

Quick Start

1. Clone the repository:

git clone https://github.com/yourusername/mcp-cli.git
cd mcp-cli

2. Install dependencies:

uv sync

3. Start the development server:

uv run cli --directory .

Contribution Guide

💡 Usage Tip

• Before submitting code, please check the format:

black .

• When submitting code, please include detailed commit information.
• After submission, update the documentation and examples.

📄 License

This project is licensed under the MIT License. For more details, please see the LICENSE file.

If you have any questions or need help, please create a new issue in the project repository.