MCP swagger ui

MCP开发工具

提供方 VasuDevAiNamaha

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

为FastMCP服务器生成Swagger UI风格的API文档,支持工具、提示和资源的自动发现与展示。

一句话选型结论

按资料字段整理

MCP swagger ui 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

API文档Python本地部署开发工具FastMCPSwaggerUIOpenAPI

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install mcp-swagger-ui

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP swagger ui当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方VasuDevAiNamaha上游标注的维护方 VasuDevAiNamaha
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

3.4 KB
来自项目仓库与上游目录的原文,未做删改

mcp大摇大摆ui

MCP的Swagger UI风格文档 FastMCP 服务器。

特性

给定一个 mcp.server.fastmcp.FastMCP 实例,此包:

  • 检查已注册的工具、提示、资源和资源模板
  • 生成类似OpenAPI的JSON文档
  • 提供与FastAPI相同的Swagger UI风格 /docs
  • 在Swagger参数列表中直接显示工具和提示参数
  • 在生成的文档中突出显示必需参数和可选参数
  • 支持文档端点的可选身份验证

安装```bash

pip install mcp-swagger-ui


对于当地发展:```bash
cd mcp_swagger_ui
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"

快速入门```python

from fastapi import FastAPI, HTTPException, Header
from mcp.server.fastmcp import FastMCP
from mcp_swagger_ui import mount_mcp_docs

your FastMCP instance

mcp = FastMCP("My MCP Server")

app = FastAPI()

def docs_auth(x_api_key: str | None = Header(default=None)) -> None:
if x_api_key != "secret-docs-key":
raise HTTPException(status_code=401, detail="Unauthorized")

mount_mcp_docs(
app,
mcp,
mount_path="/mcp-docs",
title="My MCP Server Docs",
auth_dependency=docs_auth, # optional
)
```

然后打开:

  • http://localhost:8000/mcp-docs
  • http://localhost:8000/mcp-docs/openapi.json

文档显示什么

生成的文档以可发现性为重点,当前文档为:

  • 工具说明
  • 提示性描述
  • 参数名称、类型、默认值和所需状态
  • 响应模式摘要(如果可用)

工具、提示和资源按Swagger标记分组,而显示的路径仅使用项目名称,例如 /search_users 或 /summarize_text.

测试

该项目包括 pytest 该套件具有覆盖执行功能。

  • 最低覆盖范围: 90%
  • 配置在: pyproject.toml
  • 命令指南: 测试.md

发布流程

此存储库遵循自动化的开源发布流程:

  • 拉取请求运行CI
  • 发布准备在维护者控制的发布分支中进行
  • 发布PR必须包括版本和更改日志更新
  • 发布到PyPI只发生在推送 v* 与上的包版本匹配的标记 master

贡献者指南:

  • 在需要时,将面向用户的更改记录在PR和文档中
  • 除非工作是明确的发布准备,否则不要手动编辑正常功能PR的版本

维护指南:

  • 发布流程详细信息: 发布.md
  • 测试和本地命令: 测试.md

API

  • mount_mcp_docs(app, mcp, mount_path="/mcp-docs", title="MCP Docs", version="1.0.0", auth_dependency=None) -> None
  • create_docs_router(mcp, title="MCP Docs", version="1.0.0", openapi_path="/openapi.json", auth_dependency=None) -> APIRouter

兼容性

  • FastMCP API校准:
  • 首先使用官方服务器方法: list_tools(), list_prompts(), list_resources(), list_resource_templates()
  • 处理异步和同步方法返回
  • 使用转换器助手(to_mcp_tool(), to_mcp_prompt(), to_mcp_resource())如果可用
  • 为了与FastMCP相邻对象兼容,仍然存在通用的回退自检路径。
  • 生成的模式类似于OpenAPI,侧重于可发现性/文档。
  • 此包中尚未实现对已安装的MCP JSON-RPC端点执行工具。

重要

  • 此套餐针对的是 mcp SDK FastMCP导入路径:
  • from mcp.server.fastmcp import FastMCP
  • 如果您使用的是单机版 fastmcp,由于API重叠,此程序包通常仍然有效。

出版

发布是通过GitHub Actions从GitHub Release自动完成的。

初始存储库设置仍然需要:

  • 为此存储库配置PyPI可信发布
  • 可选地保护 pypi GitHub环境

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
MCP swagger ui 怎么安装?

在客户端按下面的安装命令接入:pip install mcp-swagger-ui。装完在客户端配置里引用同一个包或端点。

MCP swagger ui 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP swagger ui 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP swagger ui 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP swagger ui 能提供哪些能力?

资料显示能力标签包括 API文档、开发工具、Python、API集成、FastMCP。具体工具清单以官方文档为准。

MCP swagger ui 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

MCP swagger ui 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。