Gumloop Unified Model Context Protocol (guMCP)

guMCP is an open-source collection of Model Context Protocol (MCP) servers that can be run both remotely and locally. The project aims to create the largest collection of MCP servers with a unified backend, fostering a community around AI integrations and the future of AGI.

Overview

While many MCP server providers are closed source, and open-source alternatives typically only support local hosting through stdio, guMCP provides:

• A comprehensive collection of MCP servers that work both locally and remotely
• Support for both stdio and SSE (Server-Sent Events) transports
• A unified backend architecture for consistent implementation
• Full open-source access to encourage community contributions

Getting Started

🎬 RECOMMENDED: Watch our quick setup video before getting started!

This under 5-minute walkthrough will save you time and help you understand the key concepts.

Prerequisites

• Python 3.11
• Git
• For Windows users: A bash-compatible shell is recommended (Git Bash, WSL, etc.)

Installation

1. Clone the repository:

   git clone https://github.com/gumloop/guMCP.git
   cd guMCP
   

2. Set up a virtual environment:

   This isolates the project dependencies from your system Python installation.

   # Create the virtual environment
   python -m venv venv
   
   # Activate it (choose the appropriate command for your OS)
   # On Unix/macOS:
   source venv/bin/activate
   
   # On Windows (Command Prompt):
   venv\Scripts\activate
   
   # On Windows (PowerShell):
   .\venv\Scripts\Activate.ps1
   
   # On Windows (Git Bash):
   source venv/Scripts/activate
   

   You'll know your virtual environment is active when you see (venv) at the beginning of your command prompt.

3. Install dependencies:

   # Install core dependencies
   pip install -r requirements.txt
   
   # Install development dependencies (for contributing)
   pip install -r requirements-dev.txt
   

4. Configure environment variables:

   # Create a local environment file from the template
   cp .env.example .env
   
   # Open the .env file in your preferred text editor and update values as needed
   # If you're using VS Code:
   code .env
   

   The .env file contains configuration for:

   • API keys for service integrations
   • Authentication settings
   • Server configuration options
   • Development environment settings

Usage

Running SSE Servers

An SSE server can be run locally. This will provide a single URL and host every server available.

To start the SSE development server, run:

./start_sse_dev_server.sh

For convenience, we also provide a lightweight MCP Client to connect to SSE servers. Usage:

python tests/clients/RemoteMCPTestClient.py --endpoint=http://localhost:8000/simple-tools-server/local

Running Stdio Servers

python src/servers/local.py --server=simple-tools-server

For convenience, we also provide a lightweight MCP Client to start and connect to stdio servers. Usage:

 python tests/clients/LocalMCPTestClient.py --server=simple-tools-server

Supported Servers and Authentication Methods

The following table provides an overview of the current servers implemented in guMCP, their authentication requirements, and relative ease of use with different authentication methods:

Server	Auth Type	Remote Auth (e.g., Cursor)	Local Auth (e.g., Claude Desktop)	Documentation

Contributing

We welcome contributions! Please see our CONTRIBUTING.md for guidelines.

Key areas for contribution:

• New server implementations
• Transport improvements
• Documentation
• Test coverage
• Bug fixes

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the LICENSE file for details.

Security

Security is the single highest priority for us.

That's why Gumloop is SOC 2 Type II, GDPR, and HIPAA compliant, and why for this OSS repo, we're actively rewarding those who responsibly disclose serious vulnerabilities and exploits to security@gumloop.com.

Community

• GitHub Issues: Bug reports and feature requests
• GitHub Discussions: General questions and discussions
• Forum: Community discussions and support

Acknowledgments

This project builds on the Model Context Protocol (MCP) specification and is inspired by the work of various MCP implementations in the community, especially those at Anthropic.

Thank you to all the contributors that have provided feedback, advice, and early servers for the repository.