Mcp-Swagger-Server
by zaizaizhao
user-flow-diagram.html•25.8 kB
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>MCP Swagger Server - 用户交互流程图</title>
<style>
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Helvetica Neue', Arial, sans-serif;
line-height: 1.6;
color: #333;
background: #f8f9fa;
padding: 20px;
}
.container {
max-width: 1400px;
margin: 0 auto;
background: white;
border-radius: 15px;
box-shadow: 0 20px 40px rgba(0,0,0,0.1);
overflow: hidden;
}
.header {
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white;
padding: 30px;
text-align: center;
}
.header h1 {
font-size: 2.5rem;
margin-bottom: 10px;
font-weight: 700;
}
.header p {
font-size: 1.1rem;
opacity: 0.9;
}
.content {
padding: 40px;
}
.flow-diagram {
display: flex;
flex-direction: column;
gap: 30px;
margin: 30px 0;
}
.flow-section {
background: #f8f9fa;
border-radius: 12px;
padding: 30px;
position: relative;
}
.section-title {
font-size: 1.5rem;
font-weight: 600;
color: #495057;
margin-bottom: 20px;
display: flex;
align-items: center;
gap: 10px;
}
.flow-steps {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
gap: 20px;
margin: 20px 0;
}
.step-card {
background: white;
border-radius: 8px;
padding: 20px;
border-left: 4px solid #667eea;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
position: relative;
transition: all 0.3s ease;
}
.step-card:hover {
transform: translateY(-2px);
box-shadow: 0 4px 8px rgba(0,0,0,0.15);
}
.step-number {
position: absolute;
top: -10px;
left: 20px;
background: #667eea;
color: white;
width: 30px;
height: 30px;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
font-weight: 600;
font-size: 0.9rem;
}
.step-title {
font-size: 1.1rem;
font-weight: 600;
color: #495057;
margin-bottom: 10px;
margin-top: 10px;
}
.step-description {
color: #6c757d;
font-size: 0.9rem;
line-height: 1.5;
}
.step-details {
margin-top: 15px;
padding-top: 15px;
border-top: 1px solid #e9ecef;
}
.detail-item {
display: flex;
align-items: center;
gap: 8px;
margin-bottom: 8px;
font-size: 0.85rem;
color: #6c757d;
}
.arrow-down {
text-align: center;
font-size: 2rem;
color: #667eea;
margin: 10px 0;
}
.flow-branch {
display: flex;
gap: 20px;
margin: 20px 0;
}
.branch-option {
flex: 1;
background: white;
border-radius: 8px;
padding: 20px;
border: 2px solid #e9ecef;
transition: all 0.3s ease;
}
.branch-option:hover {
border-color: #667eea;
background: #f0f4ff;
}
.branch-title {
font-weight: 600;
color: #495057;
margin-bottom: 10px;
display: flex;
align-items: center;
gap: 8px;
}
.branch-description {
color: #6c757d;
font-size: 0.9rem;
}
.error-handling {
background: #fff3cd;
border-left-color: #ffc107;
}
.success-path {
background: #d4edda;
border-left-color: #28a745;
}
.decision-point {
background: #d1ecf1;
border-left-color: #17a2b8;
}
.user-journey {
margin: 40px 0;
}
.journey-timeline {
position: relative;
padding-left: 40px;
}
.journey-timeline::before {
content: '';
position: absolute;
left: 20px;
top: 0;
bottom: 0;
width: 2px;
background: #667eea;
}
.journey-step {
position: relative;
margin-bottom: 30px;
padding: 20px;
background: white;
border-radius: 8px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}
.journey-step::before {
content: '';
position: absolute;
left: -28px;
top: 20px;
width: 16px;
height: 16px;
background: #667eea;
border-radius: 50%;
border: 3px solid white;
}
.journey-title {
font-weight: 600;
color: #495057;
margin-bottom: 8px;
}
.journey-description {
color: #6c757d;
font-size: 0.9rem;
}
.wireframe-section {
margin: 40px 0;
padding: 30px;
background: #f8f9fa;
border-radius: 12px;
}
.wireframe-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 20px;
margin-top: 20px;
}
.wireframe-card {
background: white;
border: 2px dashed #dee2e6;
border-radius: 8px;
padding: 20px;
text-align: center;
min-height: 200px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
}
.wireframe-title {
font-weight: 600;
color: #495057;
margin-bottom: 10px;
}
.wireframe-elements {
list-style: none;
padding: 0;
margin: 0;
text-align: left;
width: 100%;
}
.wireframe-elements li {
padding: 5px 0;
color: #6c757d;
font-size: 0.9rem;
border-bottom: 1px solid #e9ecef;
}
.wireframe-elements li:last-child {
border-bottom: none;
}
@media (max-width: 768px) {
.flow-steps {
grid-template-columns: 1fr;
}
.flow-branch {
flex-direction: column;
}
.wireframe-grid {
grid-template-columns: 1fr;
}
}
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>🔄 MCP Swagger Server</h1>
<p>用户交互流程图 & 界面原型设计</p>
</div>
<div class="content">
<!-- 主要用户流程 -->
<div class="flow-diagram">
<div class="flow-section">
<h2 class="section-title">🚀 主要用户流程</h2>
<div class="flow-steps">
<div class="step-card">
<div class="step-number">1</div>
<div class="step-title">🌐 选择输入方式</div>
<div class="step-description">
用户可以通过三种方式提供 OpenAPI 规范
</div>
<div class="step-details">
<div class="detail-item">📝 URL 地址输入</div>
<div class="detail-item">📁 文件上传</div>
<div class="detail-item">✏️ 文本粘贴</div>
</div>
</div>
<div class="step-card">
<div class="step-number">2</div>
<div class="step-title">🔍 规范验证</div>
<div class="step-description">
系统自动验证 OpenAPI 规范的格式和完整性
</div>
<div class="step-details">
<div class="detail-item">✅ 格式验证</div>
<div class="detail-item">📊 结构分析</div>
<div class="detail-item">⚠️ 问题检测</div>
</div>
</div>
<div class="step-card">
<div class="step-number">3</div>
<div class="step-title">📋 API 预览</div>
<div class="step-description">
展示解析后的 API 信息和端点列表
</div>
<div class="step-details">
<div class="detail-item">📈 基本信息</div>
<div class="detail-item">🔗 端点列表</div>
<div class="detail-item">🏷️ 标签分类</div>
</div>
</div>
<div class="step-card">
<div class="step-number">4</div>
<div class="step-title">⚙️ 配置选项</div>
<div class="step-description">
用户可以自定义转换参数和过滤条件
</div>
<div class="step-details">
<div class="detail-item">🎯 端点过滤</div>
<div class="detail-item">🔧 高级选项</div>
<div class="detail-item">🌐 传输协议</div>
</div>
</div>
<div class="step-card">
<div class="step-number">5</div>
<div class="step-title">🔄 执行转换</div>
<div class="step-description">
系统将 OpenAPI 规范转换为 MCP 格式
</div>
<div class="step-details">
<div class="detail-item">⚡ 快速转换</div>
<div class="detail-item">📊 进度显示</div>
<div class="detail-item">🎯 结果优化</div>
</div>
</div>
<div class="step-card">
<div class="step-number">6</div>
<div class="step-title">📦 结果输出</div>
<div class="step-description">
提供多种方式获取转换结果
</div>
<div class="step-details">
<div class="detail-item">💾 下载文件</div>
<div class="detail-item">📋 复制代码</div>
<div class="detail-item">🚀 直接启动</div>
</div>
</div>
</div>
</div>
<!-- 决策分支 -->
<div class="flow-section">
<h2 class="section-title">🔀 输入方式分支</h2>
<div class="flow-branch">
<div class="branch-option">
<div class="branch-title">🌐 URL 输入</div>
<div class="branch-description">
<strong>场景</strong>: API 规范已在线发布<br>
<strong>优势</strong>: 实时获取最新版本<br>
<strong>要求</strong>: 网络访问权限
</div>
</div>
<div class="branch-option">
<div class="branch-title">📁 文件上传</div>
<div class="branch-description">
<strong>场景</strong>: 本地开发或私有 API<br>
<strong>优势</strong>: 支持本地文件<br>
<strong>格式</strong>: JSON, YAML, YML
</div>
</div>
<div class="branch-option">
<div class="branch-title">📝 文本输入</div>
<div class="branch-description">
<strong>场景</strong>: 快速测试或调试<br>
<strong>优势</strong>: 即时编辑和验证<br>
<strong>用途</strong>: 原型设计和测试
</div>
</div>
</div>
</div>
<!-- 错误处理流程 -->
<div class="flow-section">
<h2 class="section-title">⚠️ 错误处理流程</h2>
<div class="flow-steps">
<div class="step-card error-handling">
<div class="step-number">!</div>
<div class="step-title">🚫 输入验证失败</div>
<div class="step-description">
当用户输入无效时的处理流程
</div>
<div class="step-details">
<div class="detail-item">❌ 显示具体错误信息</div>
<div class="detail-item">💡 提供修复建议</div>
<div class="detail-item">🔄 允许重新输入</div>
</div>
</div>
<div class="step-card error-handling">
<div class="step-number">!</div>
<div class="step-title">🌐 网络访问失败</div>
<div class="step-description">
URL 无法访问时的处理流程
</div>
<div class="step-details">
<div class="detail-item">🔄 自动重试机制</div>
<div class="detail-item">⏱️ 超时设置</div>
<div class="detail-item">🔐 认证问题检测</div>
</div>
</div>
<div class="step-card error-handling">
<div class="step-number">!</div>
<div class="step-title">⚙️ 转换失败</div>
<div class="step-description">
MCP 转换过程中出现错误时的处理
</div>
<div class="step-details">
<div class="detail-item">📝 详细错误日志</div>
<div class="detail-item">🔧 参数调整建议</div>
<div class="detail-item">💬 技术支持联系</div>
</div>
</div>
</div>
</div>
<!-- 成功路径 -->
<div class="flow-section">
<h2 class="section-title">✅ 成功完成流程</h2>
<div class="flow-steps">
<div class="step-card success-path">
<div class="step-number">✓</div>
<div class="step-title">🎉 转换成功</div>
<div class="step-description">
MCP 工具成功生成后的后续操作
</div>
<div class="step-details">
<div class="detail-item">📊 结果统计显示</div>
<div class="detail-item">🔍 工具列表预览</div>
<div class="detail-item">⚡ 性能指标报告</div>
</div>
</div>
<div class="step-card success-path">
<div class="step-number">✓</div>
<div class="step-title">💾 结果保存</div>
<div class="step-description">
多种方式保存和使用转换结果
</div>
<div class="step-details">
<div class="detail-item">📁 配置文件下载</div>
<div class="detail-item">📋 一键复制代码</div>
<div class="detail-item">🔗 分享结果链接</div>
</div>
</div>
<div class="step-card success-path">
<div class="step-number">✓</div>
<div class="step-title">🚀 服务启动</div>
<div class="step-description">
直接启动 MCP 服务或集成到现有系统
</div>
<div class="step-details">
<div class="detail-item">⚡ 一键启动服务</div>
<div class="detail-item">🔧 自定义启动参数</div>
<div class="detail-item">📈 运行状态监控</div>
</div>
</div>
</div>
</div>
</div>
<!-- 用户旅程时间线 -->
<div class="user-journey">
<h2 class="section-title">👤 用户旅程时间线</h2>
<div class="journey-timeline">
<div class="journey-step">
<div class="journey-title">🎯 需求识别</div>
<div class="journey-description">
用户意识到需要将现有的 REST API 集成到 AI 助手中，发现了 MCP 协议的优势
</div>
</div>
<div class="journey-step">
<div class="journey-title">🔍 工具发现</div>
<div class="journey-description">
用户找到 MCP Swagger Server 工具，了解其功能和优势
</div>
</div>
<div class="journey-step">
<div class="journey-title">🚀 首次使用</div>
<div class="journey-description">
用户访问 Web 界面，选择合适的输入方式（URL/文件/文本）
</div>
</div>
<div class="journey-step">
<div class="journey-title">⚙️ 配置定制</div>
<div class="journey-description">
根据具体需求调整转换参数，如端点过滤、传输协议等
</div>
</div>
<div class="journey-step">
<div class="journey-title">🔄 执行转换</div>
<div class="journey-description">
点击转换按钮，观察进度，等待转换完成
</div>
</div>
<div class="journey-step">
<div class="journey-title">📋 结果验证</div>
<div class="journey-description">
检查生成的 MCP 工具配置，确认符合预期
</div>
</div>
<div class="journey-step">
<div class="journey-title">🚀 部署集成</div>
<div class="journey-description">
下载配置文件或直接启动服务，集成到 AI 助手环境中
</div>
</div>
<div class="journey-step">
<div class="journey-title">✅ 成功应用</div>
<div class="journey-description">
AI 助手成功调用 REST API，实现预期的功能集成
</div>
</div>
</div>
</div>
<!-- 界面布局原型 -->
<div class="wireframe-section">
<h2 class="section-title">🎨 界面布局原型</h2>
<div class="wireframe-grid">
<div class="wireframe-card">
<div class="wireframe-title">📱 头部区域</div>
<ul class="wireframe-elements">
<li>🏷️ 产品标题</li>
<li>📝 功能描述</li>
<li>🎨 品牌标识</li>
</ul>
</div>
<div class="wireframe-card">
<div class="wireframe-title">📥 输入区域</div>
<ul class="wireframe-elements">
<li>🔄 标签页切换</li>
<li>📝 输入表单</li>
<li>🔘 操作按钮</li>
<li>📊 进度指示</li>
</ul>
</div>
<div class="wireframe-card">
<div class="wireframe-title">👁️ 预览区域</div>
<ul class="wireframe-elements">
<li>📊 API 基本信息</li>
<li>🔗 端点列表</li>
<li>🏷️ 状态指示器</li>
<li>📈 统计信息</li>
</ul>
</div>
<div class="wireframe-card">
<div class="wireframe-title">⚙️ 配置区域</div>
<ul class="wireframe-elements">
<li>✅ 选项卡片</li>
<li>🔘 单选/多选</li>
<li>📝 参数输入</li>
<li>💾 配置保存</li>
</ul>
</div>
<div class="wireframe-card">
<div class="wireframe-title">📦 结果区域</div>
<ul class="wireframe-elements">
<li>💻 代码预览</li>
<li>📥 下载按钮</li>
<li>📋 复制功能</li>
<li>🚀 启动选项</li>
</ul>
</div>
<div class="wireframe-card">
<div class="wireframe-title">📄 页脚区域</div>
<ul class="wireframe-elements">
<li>ℹ️ 版权信息</li>
<li>🔗 相关链接</li>
<li>📞 联系方式</li>
</ul>
</div>
</div>
</div>
</div>
</div>
</body>
</html>
Latest Blog Posts
- MCP Moves to the Linux Foundation: Neutral Stewardship for Agentic InfrastructureBy Om-Shree-0709 on .mcpanthropicLinux Foundation
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zaizaizhao/mcp-swagger-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server