OpenAPI Slice

Name: OpenAPI Slice
Author: vvarp

本地服务

github.com/vvarp开发工具253 周前更新

代码仓库

关于 OpenAPI Slice

OpenAPI Slice 是面向处理大型 OpenAPI 规范的开发者和 Agent 的 MCP 服务。它提取指定端点及其引用组件，避免加载整份规范。

主要功能

01提取特定端点的规范片段
02递归解析引用组件
03输出 YAML 或 JSON
04加载本地文件或远程 URL
05发现可用端点

适用场景

01仅向 Agent 提供目标端点规范
02查看大型 API 定义中的端点
03从文件或 URL 加载规范

MCP 相关

向 MCP 客户端提供加载 OpenAPI 规范、列出端点、提取端点片段和查看服务状态的工具。

#openapi

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "openapi-slice": {
      "command": "uvx",
      "args": [
        "openapi-slice-mcp"
      ]
    }
  }
}

启动命令uvx openapi-slice-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiopenapi-slice-mcpstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
file_path	string	是

详细介绍

OpenAPI Slice MCP 服务

一个 MCP（Model Context Protocol）服务，可帮助你通过提取特定端点的相关部分来处理大型 OpenAPI 规范。这对使用上下文长度有限的大模型尤其有用：无需加载整个大型 OpenAPI 规范，只需提取特定端点所需的部分即可。

功能

按端点提取：获取仅包含所请求端点及其依赖项的最小 OpenAPI 规范
自动解析依赖项：递归查找并包含所有引用的组件（架构、参数等）
多种格式：以 YAML 或 JSON 格式输出
文件支持：从本地 YAML 或 JSON 文件加载 OpenAPI 规范
远程支持：直接从 URL（HTTP/HTTPS）获取 OpenAPI 规范
发现工具：列出已加载规范中的所有可用端点

工具

该服务提供以下 MCP 工具：

load_openapi_spec(file_path: str) - 从本地 YAML 或 JSON 文件加载 OpenAPI 规范
load_openapi_spec_from_url(url: str, timeout: int = 30) - 从远程 URL 加载 OpenAPI 规范
list_endpoints() - 列出当前已加载规范中的所有可用端点
extract_endpoint_slice(path: str, method: str, output_format: str = "yaml") - 提取特定端点的最小规范切片
get_server_status() - 获取服务当前状态

用法

运行服务

Stdio 模式（默认）

用于本地开发和 Claude Desktop 集成：

uvx openapi-slice-mcp

服务使用 STDIO 传输，可与任何 MCP 客户端集成。

HTTP 模式

用于 Smithery 部署或远程访问：

# Using the dedicated HTTP entry point (runs on port 8000 by default)
uvx openapi-slice-mcp-http

# Or using the main entry point with --transport flag
uvx openapi-slice-mcp --transport http --host 0.0.0.0 --port 8000

HTTP 服务在 http://host:port/mcp 上提供 MCP 协议。

支持 Markdown

登录后评论