mcp-toolsmith

Generate production-ready TypeScript MCP server templates directly from OpenAPI 3.x specs.

Install

pip install mcp-toolsmith

Quick usage

mcp-toolsmith generate https://petstore3.swagger.io/api/v3/openapi.json --out generated-petstore

Then run the generated server:

cd generated-petstore
npm install
npm run build
npm start

For a complete walkthrough (including Claude Desktop setup), see Quickstart.

Python CLI that converts OpenAPI/Swagger specifications into production-ready MCP server templates in TypeScript.

Quick install

pip install mcp-toolsmith

Features

Capability	Status	Notes
OpenAPI 3.x ingestion	✅	Validates and extracts operations from OpenAPI 3.x documents.
TypeScript ESM output	✅	Generates a Node 20+ ESM MCP server scaffold.
Quality score report	✅	Emits scoring dimensions and findings in CLI output/report.json.
Agent integration snippets	✅	Generates Claude Desktop, VS Code, and LangChain snippets.

Documentation

• Quickstart
• Troubleshooting FAQ
• Architecture ADRs
• Petstore golden example output