https://github.com/gumloop/guMCP
Gumloop Unified Model Context Protocol (guMCP)
https://github.com/gumloop/guMCP
ai automation mcp mcp-server workflow
Last synced: 12 months ago
JSON representation
Gumloop Unified Model Context Protocol (guMCP)
- Host: GitHub
- URL: https://github.com/gumloop/guMCP
- Owner: gumloop
- License: gpl-3.0
- Created: 2025-03-20T00:01:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-11T20:44:55.000Z (12 months ago)
- Last Synced: 2025-04-11T21:22:49.998Z (12 months ago)
- Topics: ai, automation, mcp, mcp-server, workflow
- Language: Python
- Homepage: https://www.gumloop.com/mcp
- Size: 1.72 MB
- Stars: 317
- Watchers: 0
- Forks: 29
- Open Issues: 12
-
Metadata Files:
- Readme: README.MD
- Contributing: CONTRIBUTING.MD
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - guMCP - An open-source Model Context Protocol (MCP) server with a Python/Node.js hybrid architecture. Features include automatic API documentation parsing, self-healing connection pools, and GDPR-compliant audit trails, making it a robust solution for secure and scalable AI integration. ([Read more](/details/gumcp.md)) `open-source` `mcp` `python` `nodejs` `gdpr` (MCP Middleware & Orchestration)
README
# 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.
>
> [](https://vimeo.com/1070438737/8dea56e6a1)
### Prerequisites
- Python 3.11
- Git
- For Windows users: A bash-compatible shell is recommended (Git Bash, WSL, etc.)
### Installation
1. **Clone the repository**:
```bash
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.
```bash
# 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**:
```bash
# Install core dependencies
pip install -r requirements.txt
# Install development dependencies (for contributing)
pip install -r requirements-dev.txt
```
4. **Configure environment variables**:
```bash
# 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:
```bash
./start_sse_dev_server.sh
```
For convenience, we also provide a lightweight MCP Client to connect to SSE servers. Usage:
```bash
python tests/clients/RemoteMCPTestClient.py --endpoint=http://localhost:8000/simple-tools-server/local
```
### Running Stdio Servers
```bash
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:
```bash
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 |
| ----------------------- | --------- | ----------------------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------- |
| **Google Services** | | | | |
| Google Sheets | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gsheets) | ⚠️ Requires GCP project & OAuth setup | [GSheets Docs](/src/servers/gsheets/README.md) |
| Gmail | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gmail) | ⚠️ Requires GCP project & OAuth setup | [Gmail Docs](/src/servers/gmail/README.md) |
| Google Docs | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gdocs) | ⚠️ Requires GCP project & OAuth setup | [GDocs Docs](/src/servers/gdocs/README.md) |
| Google Drive | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gdrive) | ⚠️ Requires GCP project & OAuth setup | [GDrive Docs](/src/servers/gdrive/README.md) |
| Google Calendar | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gcalendar) | ⚠️ Requires GCP project & OAuth setup | [GCalendar Docs](/src/servers/gcalendar/README.md) |
| Google Maps | API Key | ⚠️ Coming soon | ⚠️ Requires GCP project & API Key | [GMaps Docs](/src/servers/gmaps/README.md) |
| Google Meet | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires GCP project & OAuth setup | [GMeet Docs](/src/servers/gmeet/README.md) |
| YouTube | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/youtube) | ⚠️ Requires GCP project & OAuth setup | [YouTube Docs](/src/servers/youtube/README.md) |
| **Communication Tools** | | | | |
| Slack | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/slack) | ⚠️ Requires OAuth setup with HTTPS redirect | [Slack Docs](/src/servers/slack/README.md) |
| Outlook | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/outlook) | ⚠️ Requires Azure app registration | [Outlook Docs](/src/servers/outlook/README.md) |
| X (Twitter) | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires X Developer Account | [X Docs](/src/servers/x/README.md) |
| Reddit | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires Reddit Developer App | [Reddit Docs](/src/servers/reddit/README.md) |
| **Productivity Tools** | | | | |
| Airtable | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/airtable) | ⚠️ Requires Airtable OAuth application | [Airtable Docs](/src/servers/airtable/README.md) |
| Linear | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/linear) | ⚠️ Requires Linear OAuth application | [Linear Docs](/src/servers/linear/README.md) |
| Attio | Mixed | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/attio) | ⚠️ Requires Attio OAuth application | [Attio Docs](/src/servers/attio/README.md) |
| Notion | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/notion) | ⚠️ Requires Notion OAuth application | [Notion Docs](/src/servers/notion/README.md) |
| **Business Tools** | | | | |
| HubSpot | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/hubspot) | ⚠️ Requires HubSpot OAuth application | [HubSpot Docs](/src/servers/hubspot/README.md) |
| SendGrid | API Key | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/sendgrid) | ✅ Easy - Simple API key setup | [SendGrid Docs](/src/servers/sendgrid/README.md) |
| QuickBooks | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires Intuit OAuth application | [QuickBooks Docs](/src/servers/quickbooks/README.md) |
| Typeform | API Key | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/typeform) | ✅ Easy - Simple API key setup | [Typeform Docs](/src/servers/typeform/README.md) |
| Stripe | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires Stripe OAuth setup | [Stripe Docs](/src/servers/stripe/README.md) |
| Instacart | API Key | ⚠️ Coming soon | ✅ Easy - Simple API key setup | [Instacart Docs](/src/servers/instacart/README.md) |
| **Search Tools** | | | | |
| Perplexity | API Key | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/perplexity) | ✅ Easy - Simple API key setup | [Perplexity Docs](/src/servers/perplexity/README.md) |
| Hacker News | None | ✅ No auth required | ✅ No auth required | [Hacker News Docs](/src/servers/hackernews/README.md) |
| **Development Tools** | | | | |
| GitHub | OAuth 2.0 | ⚠️ Coming soon | ⚠️ Requires GitHub OAuth application | [GitHub Docs](/src/servers/github/README.md) |
| Simple Tools Server | None | ✅ No auth required | ✅ No auth required | [Simple Tools Docs](/src/servers/simple-tools-server/README.md) |
## Contributing
We welcome contributions! Please see our [CONTRIBUTING.md](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](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](https://trust.gumloop.com/), 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](https://forum.gumloop.com/): 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.