none.api - OpenAPI Explorer MCP Server

Professional OpenAPI explorer for the Model Context Protocol (MCP), optimized for Frontend Development and Backend Contract Verification.

What is this?

This MCP server allows Large Language Models (LLMs) like Claude or Cursor to dynamically explore, understand, and interact with any API that has an OpenAPI/Swagger specification.

It is specifically designed to:

1. Accelerate Frontend Development: Generate types, Zod schemas, mock data, and data-fetching hooks (Axios/TanStack Query) directly from the API definition.
2. Verify Backend Implementation: Validate backend response objects against the OpenAPI contract to ensure the implementation matches the specification.

Installation

Using npx (Recommended)

You can run the server directly without installation:

npx @nonetss/none.api

Global Installation

npm install -g @nonetss/none.api

Key Features

• Smart Exploration: Categorized endpoint listing and keyword-based search (with multilingual synonym support).
• Frontend Factory:
  • Generate TypeScript Interfaces for requests and responses.
  • Generate Zod Schemas for form validation.
  • Generate React/Axios/TanStack Query snippets.
  • Generate Mock Data for UI prototyping.
• Backend Guard:
  • Response Validation: Compare JSON data against OpenAPI schemas using AJV.
  • Dependency Mapping: Understand relationships between resources (e.g., which endpoint provides the ID needed for another).
• Security: Automatic authentication support (Bearer/API Key) and secure environment-locked configuration.

Tools Overview

| Tool | Focus | Description | | :---------------------- | :----------- | :------------------------------------------------------------- | | list_endpoints | Exploration | Lists all endpoints grouped by functional categories. | | list_tags | Exploration | Lists all tags (functional categories) in the API. | | search_by_tag | Exploration | Lists all endpoints associated with a specific tag. | | find_endpoint | Exploration | Intelligent search by intent or keyword (e.g., "delete user"). | | get_endpoint_info | Analysis | Detailed documentation, parameters, and response codes. | | get_request_schema | Analysis | Returns the JSON schema for an endpoint's request body. | | get_response_schema | Analysis | Returns the JSON schema for a specific response status code. | | get_typescript_types | Frontend | Generates ready-to-use TypeScript interfaces. | | get_zod_schema | Frontend | Generates Zod validation schemas. | | get_framework_snippet | Frontend | Generates Axios or TanStack Query code. | | get_fetch_snippet | Frontend | Generates a native fetch snippet for quick integration. | | get_mock_data | Prototyping | Generates high-fidelity mock data based on schemas. | | map_dependencies | Architecture | Analyzes data flow and ID relationships between routes. | | get_security_info | Security | Shows security requirements for the API or specific routes. | | set_security_context | Security | Sets authentication headers for subsequent requests. | | call_endpoint | Debug | Executes real HTTP calls to the configured API. | | validate_response | Backend | Validates a JSON object against the API contract. |

Configuration

Add this to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "none.api": {
      "command": "npx",
      "args": ["-y", "@nonetss/none.api"],
      "env": {
        "OPENAPI_URL": "http://localhost:3000/doc",
        "AUTH_EMAIL": "[email protected]",
        "AUTH_PASSWORD": "your-password",
        "AUTH_PATH": "/api/auth/login"
      }
    }
  }
}

Development Workflow

1. Build: npm run build (uses tsc + tsc-alias for path resolution).
2. Formatting: Prettier is included.
3. Git Hooks: Automated formatting on commit via husky and lint-staged.