Navigation Menu

gumloop / guMCP Public

Gumloop Unified Model Context Protocol (guMCP) www.gumloop.com/mcp

License

GPL-3.0 license

gumloop/guMCP

main

Go to file

Code

Folders and files

Name| Name| Last commit message| Last commit date ---|---|---|--- scripts| scripts src| src tests| tests .env.example| .env.example .gitignore| .gitignore CONTRIBUTING.MD| CONTRIBUTING.MD LICENSE| LICENSE README.MD| README.MD requirements-dev.txt| requirements-dev.txt requirements.in| requirements.in requirements.txt| requirements.txt setup.cfg| setup.cfg start_remote_dev_server.sh| start_remote_dev_server.sh

Latest commit

History

20 Commits

Gumloop Unified Model Context Protocol (guMCP)

guMCP 是一个开源的 Model Context Protocol (MCP) 服务器集合，可以在本地和远程运行。该项目旨在创建最大的 MCP 服务器集合，并使用统一的后端，从而促进围绕 AI 集成和 AGI 未来的社区。

Overview

虽然许多 MCP 服务器提供商是闭源的，并且开源替代方案通常只支持通过 stdio 进行本地托管，但 guMCP 提供了：

• 一个全面的 MCP 服务器集合，可以在本地和远程工作
• 支持 stdio 和 SSE (Server-Sent Events) 传输
• 一个用于一致实现的统一后端架构
• 完全开源，鼓励社区贡献

Features

• 双传输支持: 所有服务器都支持：
  • 通过 stdio 进行本地托管
  • 通过 SSE 进行远程托管
• 统一后端: 所有服务器具有一致的实现模式
• 广泛的服务器集合: 包括以下服务器：
  • 文件系统和数据库
  • 开发工具
  • Web 和浏览器自动化
  • 生产力和沟通
  • AI 和专业工具

Getting Started

Prerequisites

• Python 3.11
• Git

Installation

1. 克隆存储库:

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

2. 创建并激活虚拟环境:

python -m venv venv
source venv/bin/activate # On Unix/macOS
venv\Scripts\activate   # On Windows

3. 安装依赖:

pip install -r requirements.txt
pip install -r requirements-dev.txt

4. 设置环境变量:

cp .env.example .env # 然后使用您的配置进行编辑

Usage

Running Stdio Servers

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

为了方便起见，我们还提供了一个轻量级的 MCP Client 来启动和连接到 stdio 服务器。 用法：

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

Running SSE Servers

可以在本地运行 SSE 服务器。 这将提供一个 URL 并托管每个可用的服务器。 要启动 SSE 开发服务器，请运行：

./start_remote_dev_server.sh

为了方便起见，我们还提供了一个轻量级的 MCP Client 来连接到 SSE 服务器。 用法：

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

Contributing

欢迎贡献! 请参阅我们的 CONTRIBUTING.md 获取指南。

主要贡献领域：

• 新的服务器实现
• 传输改进
• 文档
• 测试覆盖率
• Bug 修复

License

该项目已获得 GNU General Public License v3.0 (GPL-3.0) 的许可 - 有关详细信息，请参见 LICENSE 文件。

Security

安全是我们的首要任务。

这就是为什么 Gumloop 符合 SOC 2 Type II、GDPR 和 HIPAA 标准，以及为什么对于此 OSS 存储库，我们积极奖励那些负责任地向 security@gumloop.com 披露严重漏洞和利用的人。

Community

• GitHub Issues: Bug 报告和功能请求
• GitHub Discussions: 常规问题和讨论
• Forum: 社区讨论和支持

Acknowledgments

该项目基于 Model Context Protocol (MCP) 规范，并受到社区中各种 MCP 实现的启发，尤其是 Anthropic 的实现。

感谢所有为存储库提供反馈、建议和早期服务器的贡献者。