MCPHub Lab
MCPHub LabRegistryorval-labs/orval
orval-labs

orval labs/orval

Built by orval-labs • 5,619 stars

Visit Repository

What is orval labs/orval?

orval is able to generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats. 🍺

How to use orval labs/orval?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add orval labs/orval using the following command: npx @modelcontextprotocol/orval-labs-orval 4. Restart the client and verify the new tools are active.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/orval-labs-orval --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/orval-labs-orval

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

orval labs/orval FAQ

Q

Is orval labs/orval safe?

Yes, orval labs/orval follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is orval labs/orval up to date?

orval labs/orval is currently active in the registry with 5,619 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for orval labs/orval?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub

npm version NPM Downloads License: MIT tests orval Gurubase

<p align="center"> <img src="./logo/orval-logo-horizontal.svg?raw=true" width="500" height="160" alt="orval - Restfull Client Generator" /> </p> <h1 align="center"> Generate Typescript clients from OpenAPI specification! </h1>

Code Generation

orval generates type-safe JS clients (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats.

[!IMPORTANT] Version 8.0.0+ comes with a lot of improvements and changes please see the Migration Guide

Supported clients

generate models, requests, hooks, mocks and more, for these supported clients:

Samples

You can find some samples below:

Playground

Try Orval out for yourself using our Playground application!

Developers

This project uses Bun for package management and building. Bun install guide.

Build Scripts

  • bun run nuke:all - Completely clean your workspace by removing all build artifacts, node_modules, and cached files. Use this when you want to start fresh.

  • bun run build - Build the project and make changes available to the workspace. Run this after making code changes to compile TypeScript and prepare the project for use.

  • bun run typecheck - Run TypeScript type checking across all packages.

Test Scripts

  • bun run test - Run unit tests in all packages.

  • bun run update-samples - Generate sample outputs using the newly built version of Orval. This regenerates the sample code based on the current build.

  • bun run test:samples - Run tests in the samples directory using the newly generated output from update-samples.

  • bun run test:snapshots - Run snapshot tests to verify generated sample outputs match the committed snapshots. Fails if any generated file differs from its snapshot.

  • bun run test:snapshots:update - Regenerate snapshot files to match the current generated output. Run this after bun run update-samples when the generated output has intentionally changed.

  • bun run test:cli - Test that the generated output (not samples) is valid TypeScript. This validates the TypeScript compilation of the generated code.

Development Workflow

A typical development workflow would be:

  1. Make your code changes
  2. Run bun run build to compile your changes
  3. Run bun run typecheck to verify package typings
  4. Run bun run lint to catch lint issues early
  5. Run bun run test to run unit tests in packages
  6. Run bun run test:snapshots to verify generated output matches snapshots

If step 6 fails because the generated output has intentionally changed, run bun run test:snapshots:update to update the snapshots.

If you encounter issues or want to start completely fresh:

  1. Run bun run nuke:all to clean everything
  2. Reinstall dependencies and rebuild from scratch

Sponsors

Thank you to all our sponsors! 🍻

Support orval development by Open Collective and your logo will be displayed here with a link to your website.

<a href="https://opencollective.com/orval"> <img src="https://orval.dev/images/orval-logo-horizontal.svg?raw=true" width="300" alt="Become a sponsor" /> </a>

Backers

Thank you to all our backers! 🙏

Support us with a one-time donation and help us continue our activities on Open Collective.

<a href="https://opencollective.com/orval"> <img src="https://orval.dev/images/emblem.svg" width="50" height="50" alt="Backer" /> </a> <a href="https://opencollective.com/orval"> <img src="https://orval.dev/images/emblem.svg" width="50" height="50" alt="Backer" /> </a> <a href="https://opencollective.com/orval"> <img src="https://orval.dev/images/emblem.svg" width="50" height="50" alt="Backer" /> </a>

Note: After becoming a sponsor or backer, please contact us on Discord to upload your logo.

Star History

<a href="https://star-history.com/#orval-labs/orval&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=orval-labs/orval&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=orval-labs/orval&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=orval-labs/orval&type=Date" /> </picture> </a>

All Thanks To Our Contributors:

<a href="https://github.com/orval-labs/orval/graphs/contributors"> <img src="https://contrib.rocks/image?repo=anymaniax/orval" /> </a>

Global Ranking

8.5
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "orval-labs-orval": { "command": "npx", "args": ["orval-labs-orval"] } } }