Mcphub Render

MCPHub-一键部署渲染

只需单击一下即可将MCPHub部署到Render.com！MCPHub是模型上下文协议（MCP）开发的完整平台，可以轻松地设计、测试、部署和管理MCP服务器。

🚀 快速部署


单击上面的按钮将MCPHub部署到您的Render帐户。

📋 部署什么

部署MCPHub时，您将获得：

• MCP工作室 -用于创建和管理MCP配置的可视化界面
• MCP电桥 -从JSON配置托管多个MCP服务器的运行时服务器
• 巨蟒发动机 -基于Python的自定义工具执行引擎
• 完整平台 -集成前端、后端和Python引擎的Docker镜像

🔐 查找您的凭据

部署完成后，您需要找到自动生成的密码才能访问MCPHub。

步骤1：导航到您的服务

1. 去你的 渲染仪表板
2. 单击新部署的服务（名为 mcphub-all)

步骤2：查看日志

1. 在服务页面中，单击 “日志” 在左侧边栏中
2. 从容器中查找启动日志

步骤3：查找密码

查找显示以下内容的日志条目：

=================================================
MCPHub Authentication Credentials
=================================================
   Username: admin
   Password: [your-auto-generated-password]
=================================================
IMPORTANT: Save these credentials immediately!
=================================================

重要提示： 密码在部署过程中自动生成。请确保立即保存，因为它在日志中只显示一次。

备选方案：检查环境变量

您还可以在环境变量中找到您的密码：

1. 在您的服务页面中，单击 “环境” 在左侧边栏中
2. 寻找 MCPHUB_AUTH_PASSWORD 变量
3. 点击眼睛图标以显示密码

🌐 访问MCPHub

部署后，您的MCPHub实例将在一个唯一的渲染URL上可用。

查找您的MCPHub URL

1. 去你的 渲染仪表板
2. 单击新部署的服务（名为 mcphub-all)
3. 点击 “事件” 在左侧边栏中
4. 查找显示您的服务URL的部署事件
5. 您的MCPHub URL将采用以下格式：

   https://your-service-name.onrender.com

例子：

https://mcphub-all-xyz123.onrender.com

首次登录

1. 导航到您的MCPHub URL
2. 当系统提示进行身份验证时：

- 用户名： admin - 密码： \[日志中的密码\]

1. 登录后，您将看到 欢迎向导 这将指导您完成：

- 后端URL配置（自动检测） - 租户ID设置（自动生成的UUID） - 可选AI模型配置

🔑 获取API身份验证令牌

要以编程方式使用MCPHub的REST API，您需要创建一个Base64编码的身份验证令牌。

创建您的身份验证令牌

API使用HTTP基本身份验证。您需要按照以下格式对凭据进行编码 username:password 如Base64。

使用命令行（Mac/Linux）：

echo -n "admin:your-password" | base64

使用命令行（Windows PowerShell）：

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("admin:your-password"))

例子： 如果您的密码是 abc123def456，运行：

echo -n "admin:abc123def456" | base64

这将输出类似以下内容： YWRtaW46YWJjMTIzZGVmNDU2

在API调用中使用令牌

一旦你有了Base64编码的令牌，就可以在 Authorization 头球

使用curl：

curl -H "Authorization: Basic YWRtaW46YWJjMTIzZGVmNDU2" \
     https://your-service-name.onrender.com/api/endpoint

使用Python：

import requests

headers = {
    'Authorization': 'Basic YWRtaW46YWJjMTIzZGVmNDU2'
}

response = requests.get('https://your-service-name.onrender.com/api/endpoint', headers=headers)

使用JavaScript/Node.js：

const headers = {
    'Authorization': 'Basic YWRtaW46YWJjMTIzZGVmNDU2'
};

fetch('https://your-service-name.onrender.com/api/endpoint', { headers })
    .then(response => response.json())
    .then(data => console.log(data));

API通用端点

• 管理员API: https://your-service-name.onrender.com/admin/*
• MCP配置API: https://your-service-name.onrender.com/api/*
• 健康检查 （无需身份验证）： https://your-service-name.onrender.com/health
• OpenAPI规范: https://your-service-name.onrender.com/q/openapi
• Swagger 用户界面: https://your-service-name.onrender.com/swagger-ui

除以下端点外的所有端点 /health 需要带有基本身份验证令牌的Authorization标头。

🔧 配置

环境变量

以下环境变量已在中预先配置 render.yaml:

自定义部署

您可以通过以下方式自定义部署：

1. 分叉此存储库
2. 修改 render.yaml 使用您的首选设置
3. 从您的fork部署 而不是这个存储库

📚 特性

视觉MCP设计

• 通过直观的用户界面创建MCP配置
• 支持REST、gRPC、GraphQL和SOAP协议
• 实时验证和测试

身份验证支持

• 具有自动刷新功能的JWT身份验证
• OAuth 2.0（客户端凭据和授权代码流）
• 自定义OAuth2提供商（Keycloak、Auth0、AWS Cognito等）
• 静态标头和标头转发

AI驱动的功能

• 多模型支持（OpenAI、Anthropic、Groq、自定义提供商）
• 自动生成描述
• 智能工具的选择和改进建议

基于角色的访问控制

• 创建和管理具有特定MCP访问权限的角色
• 导出/导入角色配置
• 将角色部署到生产环境

测试与开发

• 从已部署的MCP服务器进行实时工具自检
• 具有版本控制的多查询测试
• 为OpenAI微调数据集导出

💡 提示

保存您的租户ID

欢迎向导将为您的租户ID生成UUID。请确保：

1. 显示时复制租户ID
2. 将其保存在安全位置
3. 如果重新部署，您将需要此ID来访问MCP配置

升级MCPHub

要升级到最新版本：

1. 转到Render仪表板中的服务
2. 点击 “手动部署” → “部署最新提交”
3. 或者在中更新图像标签 render.yaml 并推动变革

使用持久存储

默认部署使用内存中存储（空闲层）。生产：

1. 升级到付费渲染计划
2. 更新 MCP_STORAGE_PROVIDER 使用数据库
3. 添加数据库连接环境变量

🏗️ 建筑

MCPHub使用多服务架构：

┌─────────────────────────────────────┐
│         nginx (Port 3000)           │
│  - Frontend serving at /designer    │
│  - Backend proxy                    │
│  - Basic Authentication             │
└─────────────────────────────────────┘
           │
           ├──> Frontend (Next.js)
           │    - MCP Studio UI
           │    - Visual configuration
           │
           ├──> Backend (Quarkus:8080)
           │    - MCP Bridge runtime
           │    - REST/GraphQL APIs
           │    - Multi-tenant support
           │
           └──> Python Engine (Port 8082)
                - Custom tool execution
                - Python-based MCP tools

📝 许可证

MCPHub根据MIT许可证获得许可。有关详细信息，请参阅主存储库。

🤝 贡献

欢迎投稿！请访问主存储库进行贡献：

______________________________________________________________________

主存储库: