Skip to main content

A command-line interface for interacting with MCP servers

Project description

MCP Hive Proxy

A command-line interface for interacting with MCP (Model Context Protocol) servers using the SSE protocol.

Features

  • Ask questions to any MCP server directly from the command line
  • Manage server configurations with easy add, remove, and list operations
  • Set default servers for quick access
  • Import and export server configurations
  • Standalone script that can be run outside of a virtual environment

Installation

# From the source directory
pip install -e .

# Or once published
pip install mcp-hive-proxy

Usage

Asking Questions

# Ask a question to the default server
mcp ask "What is the best AI tool for coding?"

# Ask a question to a specific server by name
mcp ask --server team-mcp "What tools are being used in this team room?"

# Ask a question to a specific server by URL
mcp ask --url https://mcp-server.example.com/sse "What is the weather today?"

Managing Servers

# List all configured servers
mcp servers list

# Add a new server
mcp servers add my-server https://mcp-server.example.com/sse

# Remove a server
mcp servers remove my-server

# Set the default server
mcp servers set-default tweet-finder-mcp

# Export server configuration
mcp servers export --file servers.json

# Import server configuration
mcp servers import servers.json

Standalone Script

The repository also includes a standalone script mcp_cli_standalone.py that can be run directly without installing the package:

# Make it executable
chmod +x mcp_cli_standalone.py

# Run it directly
./mcp_cli_standalone.py ask "What are the latest AI trends?"

# Or copy it to a location in your PATH
cp mcp_cli_standalone.py ~/bin/mcp

Configuration

The CLI stores its configuration in ~/.config/mcp_cli/config.json. This file is created automatically when you first run the CLI, and it contains:

  • A list of configured servers with their URLs
  • The default server to use when none is specified

Requirements

  • Python 3.9 or higher
  • mcp package (installed automatically as a dependency)

License

MIT

Project details


Download files

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

Source Distribution

mcp_hive_proxy-0.4.0.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

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

mcp_hive_proxy-0.4.0-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file mcp_hive_proxy-0.4.0.tar.gz.

File metadata

  • Download URL: mcp_hive_proxy-0.4.0.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mcp_hive_proxy-0.4.0.tar.gz
Algorithm Hash digest
SHA256 6c47e83073b1d7b8d2b222706edc59668793c918d70b8a9756b05f941db921e0
MD5 9f38f05209ec2f061a5db3a6d29fa5bf
BLAKE2b-256 385542e39a3512bda4e21e46df38fceb414ec114aec5f10a51643ef9320d40c6

See more details on using hashes here.

File details

Details for the file mcp_hive_proxy-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: mcp_hive_proxy-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 7.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mcp_hive_proxy-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9250b307bba51dc96c34a9f5f5cd68339822c8a8029f2743852f0a82e9d3880a
MD5 9b8626a1db94d66df56836d1163b410c
BLAKE2b-256 849111cf5277ff47c74d33a96579832a743da66c897b99ea60fd408527f1c432

See more details on using hashes here.

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