of-mcp 0.1.1

CLI for managing MCP Gateway workspaces, backends, and agents

MCP Gateway CLI

Enterprise-grade Model Context Protocol management for Claude Desktop

The mcpgw CLI helps you manage MCP servers, workspaces, and configurations for Claude Desktop with enterprise security features.

🚀 Quick Start

pip (Recommended)

pip install of-mcp

Note: The package name is of-mcp but the command is mcpgw.

After installation, add to your PATH (if needed):

# Add to ~/.zshrc or ~/.bashrc
export PATH="$HOME/Library/Python/3.12/bin:$PATH"

Homebrew (macOS/Linux)

# Add tap
brew tap orangefennec/tap
# Install
brew install mcpgw

From source

cd cli
pip install -e .

Requirements: Python 3.9+

Quick Start

1. Login

mcpgw auth login
# Enter your email and password

2. List Workspaces

mcpgw workspace list

3. Create Workspace

mcpgw workspace create --name "Production"

4. Add Backend

mcpgw backend add WORKSPACE_ID --name "Gmail" --url "http://gmail-mcp:9000"

5. Create Agent

mcpgw agent create WORKSPACE_ID --name "My Agent"
# Save the API key shown!

Commands

Authentication

mcpgw auth login              # Login
mcpgw auth logout             # Logout
mcpgw auth whoami             # Show current user

Workspaces

mcpgw workspace list                    # List all workspaces
mcpgw workspace get WORKSPACE_ID        # Get workspace details
mcpgw workspace create                  # Create new workspace
mcpgw workspace delete WORKSPACE_ID     # Delete workspace

Backends

mcpgw backend list WORKSPACE_ID                           # List backends
mcpgw backend add WORKSPACE_ID --name X --url Y           # Add backend
mcpgw backend remove WORKSPACE_ID BACKEND_ID              # Remove backend

Backend Catalog

mcpgw catalog list                                  # Browse catalog
mcpgw catalog list --category email                 # Filter by category
mcpgw catalog enable WORKSPACE_ID BACKEND_ID        # Enable from catalog

Agents

mcpgw agent list WORKSPACE_ID                 # List agents
mcpgw agent create WORKSPACE_ID --name X      # Create agent

Configuration

Config stored in ~/.mcpgw/config.json

Environment Variables

• MCPGW_API_URL - API base URL (default: https://api.mcpgw.io/api/v1)
• MCPGW_PROFILE - Configuration profile to use
• MCPGW_TOKEN - Authentication token (for CI/CD)

Profiles

Manage multiple environments:

# Create profiles for different environments
mcpgw profile create staging --api-url https://staging.mcpgw.io/api/v1
mcpgw profile create local --api-url http://localhost:8000/api/v1

# List profiles
mcpgw profile list

# Switch between profiles
mcpgw profile use staging

# Show current profile
mcpgw profile current

Examples

Setup a new workspace

# Login
mcpgw auth login

# Create workspace
mcpgw workspace create --name "Production"

# Enable Gmail backend
WORKSPACE_ID="ws_abc123"
mcpgw catalog enable $WORKSPACE_ID backend_gmail

# Create an agent
mcpgw agent create $WORKSPACE_ID --name "Email Agent"

Get workspace info as JSON

mcpgw workspace list --json-output | jq '.[0]'

Development

# Install in development mode
cd cli
pip install -e .

# Run tests
pytest

# Build distribution
pipx run build

# Upload to PyPI
pipx run twine upload dist/*

📖 Documentation

• Environment Guide: ENVIRONMENT_GUIDE.md - Complete guide for multi-environment management
• Publishing Guide: PUBLISHING.md - How to publish to PyPI
• Distribution: DISTRIBUTION.md - Homebrew and package distribution

🔗 Links

• PyPI Package: https://pypi.org/project/of-mcp/
• Documentation: https://docs.mcpgw.io
• Website: https://mcpgw.io
• GitHub: https://github.com/orangefennec/mcp-gateway
• Support: [e-mail]

📝 License

MIT License - see LICENSE for details

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md

---

Made with ❤️ by Orange Fennec