MCP.so
ログイン
O

Openapi Navigator

@mgaruccio

リポジトリ

Openapi Navigator について

MCP server for handling large openapi specs

#openapi#api-navigator#mcp-server

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

mgaruccio

投稿者

Mike Garuccio

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "openapi-navigator": {
      "command": "uvx",
      "args": [
        "openapi-navigator"
      ],
      "env": {}
    }
  }
}

ツール

9

Load an OpenAPI specification from a local file. Args: file_path: Absolute path to the OpenAPI spec file (YAML or JSON) spec_id: Optional custom identifier for the spec. If not provided, will use 'file:{file_path}' Returns: The spec ID that was assigned to the loaded specification Note: File path must be absolute for security reasons.

Load an OpenAPI specification from a URL. Args: url: URL to the OpenAPI spec (YAML or JSON) spec_id: Optional custom identifier for the spec. If not provided, will use 'url:{url}' Returns: The spec ID that was assigned to the loaded specification

Unload an OpenAPI specification from memory. Args: spec_id: ID of the loaded spec to unload Returns: Confirmation message

List all currently loaded OpenAPI specifications. Returns: List of spec IDs that are currently loaded

Get the complete operation definition for a specific endpoint. Args: spec_id: ID of the loaded spec to query path: API path (e.g., '/users/{id}') method: HTTP method (e.g., 'GET', 'POST') Returns: The raw operation object from the OpenAPI spec, or None if not found

Search endpoints using fuzzy matching across paths, summaries, and operation IDs. To get a full list of all endpoints, use an empty string "" or a very short query like "a" as the search term. The search will return all endpoints with a relevance score of 100 when the query is very short. Args: spec_id: ID of the loaded spec to query query: Search query string. Use "" or "a" to get all endpoints. Returns: List of matching endpoints with relevance scores

Get a specific schema definition from a loaded OpenAPI specification. Args: spec_id: ID of the loaded spec to query schema_name: Name of the schema to retrieve Returns: The raw schema object from the OpenAPI spec, or None if not found

Search schema names using fuzzy matching. To get a full list of all schemas, use an empty string "" or a very short query like "a" as the search term. The search will return all schemas with a relevance score of 100 when the query is very short. Args: spec_id: ID of the loaded spec to query query: Search query string. Use "" or "a" to get all schemas. Returns: List of matching schema names with relevance scores

Get comprehensive metadata about a loaded OpenAPI specification. This includes information about the spec version, title, description, base path, servers, contact info, license, and counts of endpoints and schemas. Args: spec_id: ID of the loaded spec to query Returns: Dictionary containing spec metadata including base path and help text

概要

What is Openapi Navigator?

Openapi Navigator is an MCP server that makes OpenAPI specifications easily accessible to AI agents. It loads specs from local files or URLs and allows natural language searching of endpoints and schemas.

How to use Openapi Navigator?

Install the server with uvx openapi-navigator and add the JSON configuration to your MCP client settings. Once connected, use commands like load_spec, search_endpoints, and get_endpoint to explore and query OpenAPI specifications.

Key features of Openapi Navigator

  • Load specs from local files or URLs (OpenAPI 3.x & Swagger 2.x)
  • Smart search with fuzzy matching for endpoints and schemas
  • Manage multiple API specifications simultaneously
  • Preserves $ref structures for agent decision-making
  • Fast indexing for instant lookups and searches

Use cases of Openapi Navigator

  • API exploration – quickly understand API structure and capabilities
  • Code generation – extract endpoint/schema info for automated code creation
  • Documentation – generate comprehensive API documentation
  • Integration planning – discover API features before implementation
  • Testing – find endpoints and parameters for test automation

FAQ from Openapi Navigator

What OpenAPI versions does Openapi Navigator support?

It supports OpenAPI 3.x and Swagger 2.x specifications.

Can I load specs from a URL?

Yes, you can load specs from both local files and URLs.

Does the server handle multiple APIs at once?

Yes, it allows you to manage several API specifications simultaneously.

How does the search work?

The server uses fuzzy matching so you can search endpoints and schemas using natural language queries.

What does "reference preservation" mean?

The server maintains the $ref structures found in OpenAPI specs, keeping them intact for agent decision-making.

コメント

「その他」の他のコンテンツ

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K