jmcpx

jmcpx is a Command-Line Interface (CLI) client designed for interacting with MCP (Model Context Protocol) servers. It provides a robust set of tools to manage and interact with MCP servers while seamlessly integrating with various Large Language Model (LLM) configurations.

Features

• Session Management: Start and manage interactive sessions with MCP servers.
• Tool and Resource Listing: Retrieve and display available tools and resources provided by MCP servers.
• LLM Integration: Supports multiple LLM configurations, including OpenAI, Anthropic, and Bedrock.
• Markdown Rendering: Outputs responses in Markdown format for improved readability.
• Customizable Configurations: Easily configure MCP and LLM settings using JSON and TOML files.

Requirements

• Java: Version 21 or higher
• Maven: For dependency management and building the project

Installation

1. Clone the repository:

   git clone ...
   cd jmcpx
   
   

2. Build the project using Maven:

   mvn clean package
   

3. Run the application:

   java -jar target/jmcpx-1.0-SNAPSHOT.jar
   

Usage

The application provides several commands to interact with MCP servers and LLM configurations. Below are the available commands:

Start a Session

Start an interactive session with an MCP server:

java -jar target/jmcpx-1.0-SNAPSHOT.jar session

Options:

• -c or --mcp: Specify the location of the mcp.json file (default: <user.home>/.config/jmcpx/mcp.json).
• -l or --llm: Specify the location of the llm.toml file (default: <user.home>/.config/jmcpx/llm.toml).

List MCP Server Details

List available tools and resources from MCP servers:

java -jar target/jmcpx-1.0-SNAPSHOT.jar list

Options:

• -c or --mcp: Specify the location of the mcp.json file (default: <user.home>/.config/jmcpx/mcp.json).
• -l or --llm: Specify the location of the llm.toml file (default: <user.home>/.config/jmcpx/llm.toml).

Configuration

By default, you can place both the mcp.json and llm.toml configuration files in your user's home folder, specifically inside <user.home>/.config/jmcpx folder.

If you are using Windows, the path for your home folder by default is C:\Users\<username> (Example: C:\Users\ervin). For OSX/Linux, this would be something like /home/<username>.

You can overwrite these paths with -c flag for the mcp.json file and with -l for the llm.toml configuration file.

MCP Configuration

The mcp.json file defines the MCP servers and their configurations. Example:

{
  "mcpServers": {
    "server1": {
      "transport": "stdio",
      "command": "path/to/server1",
      "args": ["--arg1", "--arg2"],
      "env": {
        "ENV_VAR1": "value1"
      }
    },
    "server2": {
      "transport": "http",
      "url": "https://myserver.com/mcp",
      "headers": {
        "Authorization": "Bearer ..."
      }
    }
  }
}

LLM Configuration

The llm.toml file defines the LLM configurations. Example:

[[bedrock]]
modelId = "amazon.nova-pro-v1:0"
region = "us-east-1"

[[anthropic]]
modelName = "claude-sonnet-4-20250514"
apiKey = "..."
default = true

[[anthropic]]
modelName = "claude-3-7-sonnet-20250219"
apiKey = "..."

[[openai]]
modelName = "gpt-4o-2024-08-06"
apiKey = "..."

[[openai]]
modelName = "gpt-4.1-2025-04-14"
apiKey = "..."

[[google]]
modelName = "gemini-2.5-pro-preview-05-06"
apiKey = "..."

Logging

Use DEV logback Configuration

java -Dlogback.configurationFile=logback-dev.xml -jar target/jmcpx-1.0-SNAPSHOT.jar

License

This project is licensed under the MIT License. See the LICENSE file for details.