Skip to main content
Glama
orhanveli

OpenAPI Client Generator MCP

README.md
# openapi-client-generator MCP Server

A Model Context Protocol server to generate API clients by using TypeScript.


<a href="https://glama.ai/mcp/servers/taqmq8493y">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/taqmq8493y/badge" alt="OpenAPI Client Generator MCP server" />
</a>

## Features

### Resources
- Generates an axios based API client that can be used to interact with the API.
- It uses OpenAPI / Swagger specs to generate the client.

### Prompts
- `generate_client` - Generate a API client for specified OpenAPI specs.

## Development

Install dependencies:
```bash
npm install
```

Build the server:
```bash
npm run build
```

For development with auto-rebuild:
```bash
npm run watch
```

## Installation

To use with Claude Desktop, add the server config:

On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`  
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "openapi-client-generator": {
      "command": "node",
      "args": [
        "< PATH TO >/openapi-client-generator/build/index.js"
      ]
    }
  }
}
```

### Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:

```bash
npm run inspector
```

The Inspector will provide a URL to access debugging tools in your browser.

## Contributing

Feel free to contribute to the project by opening issues or submitting pull requests. We welcome any improvements or new features that align with the project's goals.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

----

Built with [Cline](https://github.com/cline/cline)

TDQS

A3.5/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion. The tool has a clear and singular purpose.

Naming Consistency5/5

The single tool uses a clear verb_noun pattern ('generate_client'), which is consistent and descriptive.

Tool Count3/5

A single tool feels thin for an OpenAPI client generator. While it may suffice for a minimal use case, most users would expect additional capabilities like validation or endpoint listing.

Completeness2/5

The tool only generates a client from a specification. Obvious gaps include validating the spec, listing endpoints, or configuring output options, which limits its usefulness.