Mcp Client Gen

MCP Client Generator

[](https://www.npmjs.com/package/mcp-client-gen) [](https://www.npmjs.com/package/mcp-client-gen) [](https://discord.gg/bSsv7XM) [](LICENSE)

Generate type-safe TypeScript clients from MCP servers.

Quick Start

# Generate client from URL
npx mcp-client-gen https://mcp.notion.com/mcp -o notion.ts

# Use the generated client

import { createNotionClient } from "./notion";
import { createMcpConnection } from "mcp-client-gen";

const connection = await createMcpConnection({
  url: "https://mcp.notion.com/mcp",
});

const notion = createNotionClient(connection);

// Fully typed based on server schema
const pages = await notion.notionSearch({ query: "Meeting Notes" });

Features

• Type-safe — Generated TypeScript types from server schemas
• Zero config auth — OAuth 2.1 with PKCE, just approve in browser
• Tree-shakable — Only bundle the methods you import

Installation

npm install -g mcp-client-gen
# or
bun add -g mcp-client-gen

CLI Usage

# URL mode (primary)
npx mcp-client-gen               # Output to stdout
npx mcp-client-gen  -o     # Output to file
npx mcp-client-gen         # Shorthand

# Config mode (reads .mcp.json, .cursor/, .vscode/)
npx mcp-client-gen                    # Interactive
npx mcp-client-gen -y                 # Accept defaults

Config File Format

// .mcp.json
{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" },
    "github": { "url": "https://api.githubcopilot.com/mcp/" },
  },
}

Authentication

No credentials required. OAuth-protected servers trigger automatic browser authentication via Dynamic Client Registration (RFC 7591) and PKCE.

License

MIT — Konstantin Tarkus

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kriasoft
• Source: kriasoft/mcp-client-gen
• License: MIT
• Homepage: https://medium.com/@koistya/why-i-built-mcp-client-generator-and-why-you-should-care-c860193ca902

Install and usage instructions live in the source repository linked above.