feat(mcp): generate an MCP server in TypeScript (--target mcp)

pnpm-workspace.yaml

@@ -1,6 +1,7 @@
 packages:
   - packages/*
   - src/bin/forge/ts/lib
+  - src/bin/forge/mcp/lib
 allowBuilds:
   esbuild: true
   workerd: true

src/bin/forge/main.rs

@@ -2,6 +2,7 @@
 //!
 //! ```text
 //! forge openapi.json --target ts --out sdk
+//! forge openapi.json --target mcp --out tools
 //! forge openapi.json --target wasm://plugin.wasm --out sdk
 //! ```
 
@@ -13,6 +14,7 @@ use std::process::ExitCode;
 use clap::Parser;
 use forge::{Err, Forge};
 
+mod mcp;
 mod ts;
 
 /// Generates an SDK from an OpenAPI document.
@@ -21,8 +23,9 @@ mod ts;
 struct Args {
     /// The OpenAPI JSON document, or - to read it from standard input.
     spec: PathBuf,
-    /// The language of the SDK: `ts` for TypeScript, or `wasm://PATH` for
-    /// the plugin compiled to a WebAssembly component at PATH.
+    /// The language of the SDK: `ts` for TypeScript, `mcp` for the tools of
+    /// an MCP server in TypeScript, or `wasm://PATH` for the plugin compiled
+    /// to a WebAssembly component at PATH.
     #[arg(long, value_parser = Target::parse)]
     target: Target,
     /// The directory to write the SDK to.
@@ -35,18 +38,22 @@ struct Args {
 enum Target {
     /// The TypeScript generator.
     Ts,
+    /// The MCP generator, which generates the tools of an MCP server in TypeScript.
+    Mcp,
     /// A plugin compiled to a WebAssembly component, at the path.
     #[cfg(feature = "wasm")]
     Wasm(PathBuf),
 }
 
 impl Target {
     fn parse(s: &str) -> Result<Target, String> {
-        if s == "ts" {
-            return Ok(Target::Ts);
+        match s {
+            "ts" => return Ok(Target::Ts),
+            "mcp" => return Ok(Target::Mcp),
+            _ => {}
         }
         let Some(path) = s.strip_prefix("wasm://") else {
-            return Err("possible values: ts, wasm://PATH".to_owned());
+            return Err("possible values: ts, mcp, wasm://PATH".to_owned());
         };
         if path.is_empty() {
             return Err("wasm:// needs the path of a plugin, as in wasm://plugin.wasm".to_owned());
@@ -75,6 +82,10 @@ fn run(args: Args) -> Result<(), Err> {
             let forge = read(&args.spec)?;
             forge::write(&args.out, forge::run(&forge, &ts::Generator)?)
         }
+        Target::Mcp => {
+            let forge = read(&args.spec)?;
+            forge::write(&args.out, forge::run(&forge, &mcp::Generator)?)
+        }
         #[cfg(feature = "wasm")]
         Target::Wasm(path) => {
             // Compiling the plugin and reading the document are both slow,