Mcp Config

MCP Config

Turn one MCP server setup into the right format for lots of apps.


• Keep one setup
• Get the right file or command for each app
• Skip hand edits across many formats

Quick start

• Copy src/ into your project
• Import the helpers
• Pick a client and transform

import { transformConfig, getClients } from "./src/index.js";

// List all supported clients
const clients = getClients();
// => [{ slug: "claude-desktop", name: "Claude Desktop", format: "json", ... }, ...]

const httpServer = {
  name: "playbooks",
  type: "http",
  url: "https://playbooks.com/api/mcp",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
};

const stdioServer = {
  name: "my-server",
  type: "stdio",
  command: "npx",
  args: ["-y", "@example/mcp-server"],
  env: { API_KEY: "secret" },
};

// Make JSON for Cursor
const result = transformConfig({
  server: httpServer,
  client: "cursor",
});

console.log(result.config);
// {
//   "mcpServers": {
//     "playbooks": {
//       "url": "https://playbooks.com/api/mcp",
//       "headers": {
//         "Authorization": "Bearer YOUR_API_KEY"
//       }
//     }
//   }
// }

// Make a CLI command for Claude Code
const cliResult = transformConfig({
  server: stdioServer,
  client: "claude-code",
});

console.log(cliResult.config);
// => claude mcp add my-server -- npx -y @example/mcp-server

Running tests

bun install
bun test

Supported clients

JSON

• Claude Desktop
• Cursor
• Windsurf
• VS Code / Copilot
• Cline / Kilo Code / Roo Code
• Zed
• JetBrains IDEs
• Amazon Q
• LM Studio
• Gemini CLI
• Augment Code
• OpenCode
• Visual Studio
• Warp
• Perplexity Desktop
• Kiro, Trae, BoltAI, Crush
• And more

CLI

• Claude Code
• Amp
• Factory (Droid)
• Rovo Dev
• OpenAI Codex CLI

API

`transformConfig(options)`

Transform a server config for a specific client.

type TransformOptions = {
  server: McpServerConfig;
  client: string; // client slug
};

t