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.5.0.tar.gz (8.0 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.5.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_hive_proxy-0.5.0.tar.gz
  • Upload date:
  • Size: 8.0 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.5.0.tar.gz
Algorithm Hash digest
SHA256 3831060630dd6d7db33dffe63e034736b295ffa736bf76d0daa1b74fa285c061
MD5 5c0087d09b9a7ed657ffe20ada6087a5
BLAKE2b-256 7417b6244a69d4cb6fa81d3a9c625aeeff1878afc639e9708f95bff12d2e3c9f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mcp_hive_proxy-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 8.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.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7cf822a7ff7439c21246305c048c4ab72e495add69dfb97a9ce674779868799f
MD5 7a7c19735639cc401d49a8a462a87d38
BLAKE2b-256 dbc5b28ef31ff3dbe0cc1ef0b466a2387605a848cdc19190c52ec1fe1ec2dd13

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