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
mcppackage (installed automatically as a dependency)
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6c47e83073b1d7b8d2b222706edc59668793c918d70b8a9756b05f941db921e0
|
|
| MD5 |
9f38f05209ec2f061a5db3a6d29fa5bf
|
|
| BLAKE2b-256 |
385542e39a3512bda4e21e46df38fceb414ec114aec5f10a51643ef9320d40c6
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9250b307bba51dc96c34a9f5f5cd68339822c8a8029f2743852f0a82e9d3880a
|
|
| MD5 |
9b8626a1db94d66df56836d1163b410c
|
|
| BLAKE2b-256 |
849111cf5277ff47c74d33a96579832a743da66c897b99ea60fd408527f1c432
|