MCP网关管理工具

HomeLab MCP Gateway with MCPJungle是一个自托管的MCP网关工具,用于管理HomeLab中的Model Context Protocol (MCP)服务器,提供Web UI和CLI管理、统一端点、HTTP和STDIO支持、访问控制和工具分组功能。

  • by mdlmarkham
  • 本地部署
  • 更新于
在 GitHub 查看 mdlmarkham/HL_DockerMCPGateway

使用说明

🌳 带MCPJungle的HomeLab MCP网关

使用自托管MCP网关 MCPJungle 用于管理HomeLab中的模型上下文协议(MCP)服务器。

部署选项

  • 本地Docker编写:下面快速开始
  • Komodo部署:集中式HomeLab管理(推荐)

快速开始

# 1. Create environment file
cp .env.example .env
# Edit .env and set POSTGRES_PASSWORD

# 2. Start services
docker compose up -d

# 3. Install MCPJungle CLI
brew install mcpjungle/mcpjungle/mcpjungle

# 4. Register an MCP server
mcpjungle register --name context7 --url https://mcp.context7.com/mcp

# 5. Connect Claude Desktop
# Add to claude_desktop_config.json:
{
  "mcpServers": {
    "mcpjungle": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8080/mcp", "--allow-http"]
    }
  }
}

什么是MCPJungle?

MCPJungle是一个生产就绪的MCP网关,提供:

  • 🖥️ Web UI+CLI -易于管理
  • 🔍 统一端点 -所有MCP服务器的单一网关
  • 📡 两种运输方式 -HTTP和STDIO支持
  • 🔒 访问控制 -企业身份验证
  • 🎯 工具组 -按客户组织工具

文档

建筑

MCP Clients → http://localhost:8080/mcp → MCPJungle Gateway
                                              ↓
                                        PostgreSQL DB
                                              ↓
                                   HTTP/STDIO MCP Servers

管理

# List servers
mcpjungle list servers

# List tools
mcpjungle list tools

# Disable a tool
mcpjungle disable tool server__tool_name

# Remove a server
mcpjungle deregister server_name

配置

编辑.env文件:

POSTGRES_PASSWORD=your_secure_password
SERVER_MODE=development  # or enterprise for auth

企业模式

对于多用户环境:

# Enable enterprise mode
SERVER_MODE=enterprise docker compose up -d

# Initialize admin
mcpjungle init-server

# Create client with limited access
mcpjungle create mcp-client my-client --allow "server1,server2"

资源

许可证

麻省理工学院