Merge pull request #22 from speakeasy-api/speakeasy-sdk-regen-1740516603

chore: 🐝 Update SDK - Generate 2.4.0

Author: chase-crumbaugh

.gitignore

@@ -1,3 +1,4 @@
+/mcp-server
 /bin
 /.eslintcache
 /models

.speakeasy/gen.lock

@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: 521af75f-d011-41f9-a5ff-9f8033773118
 management:
-  docChecksum: a16089f06495dd5f7de1f5121d72ec45
+  docChecksum: 80bdf0b395520d76da9a1e1e2896dae0
   docVersion: 0.4.0
-  speakeasyVersion: 1.501.0
-  generationVersion: 2.522.1
-  releaseVersion: 2.3.0
-  configChecksum: af4c84e6b75f7ba42bd4d7fad05a022c
+  speakeasyVersion: 1.504.0
+  generationVersion: 2.529.0
+  releaseVersion: 2.4.0
+  configChecksum: cf2dd71ca7f41b785896af8960a03d06
   repoURL: https://github.com/speakeasy-api/speakeasy-code-samples-ts.git
   installationURL: https://github.com/speakeasy-api/speakeasy-code-samples-ts
   published: true
@@ -25,6 +25,7 @@ features:
     globalServerURLs: 2.82.4
     globals: 2.82.2
     groups: 2.81.2
+    mcpServer: 0.3.0
     nameOverrides: 2.81.2
     reactQueryHooks: 0.2.2
     responseFormat: 0.2.3
@@ -76,6 +77,18 @@ generatedFiles:
   - src/lib/sdks.ts
   - src/lib/security.ts
   - src/lib/url.ts
+  - src/mcp-server/build.mts
+  - src/mcp-server/cli.ts
+  - src/mcp-server/cli/start/command.ts
+  - src/mcp-server/cli/start/impl.ts
+  - src/mcp-server/console-logger.ts
+  - src/mcp-server/mcp-server.ts
+  - src/mcp-server/resources.ts
+  - src/mcp-server/scopes.ts
+  - src/mcp-server/server.ts
+  - src/mcp-server/shared.ts
+  - src/mcp-server/tools.ts
+  - src/mcp-server/tools/codeSamplesGet.ts
   - src/models/components/httpmethod.ts
   - src/models/components/index.ts
   - src/models/components/security.ts

.speakeasy/gen.yaml

@@ -17,7 +17,7 @@ generation:
     oAuth2ClientCredentialsEnabled: false
     oAuth2PasswordEnabled: false
 typescript:
-  version: 2.3.0
+  version: 2.4.0
   additionalDependencies:
     dependencies:
       '@emotion/css': ^11.13.5

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.501.0
+speakeasyVersion: 1.504.0
 sources:
     speakeasy-OAS:
         sourceNamespace: speakeasy-oas
-        sourceRevisionDigest: sha256:46b1f9bf16dba3f2cf0af9587274ee24f54b60f323633d63a1b85b230a51e6e8
-        sourceBlobDigest: sha256:74092062b98c511fb2035986fe307d2d5de39443dac827b7bdddb853268f768c
+        sourceRevisionDigest: sha256:6180bad971055a1a572b46b6a517e12856af53066c19042d87a409f6859d4485
+        sourceBlobDigest: sha256:706c912b2e5755fdaff8d2a95ca3ce6fb1fff777a7aa49a8afcb0b909cc22892
         tags:
             - latest
-            - speakeasy-sdk-regen-1740258401
+            - speakeasy-sdk-regen-1740516603
             - 0.4.0
 targets:
     code_samples_typescript_sdk:
         source: speakeasy-OAS
         sourceNamespace: speakeasy-oas
-        sourceRevisionDigest: sha256:46b1f9bf16dba3f2cf0af9587274ee24f54b60f323633d63a1b85b230a51e6e8
-        sourceBlobDigest: sha256:74092062b98c511fb2035986fe307d2d5de39443dac827b7bdddb853268f768c
+        sourceRevisionDigest: sha256:6180bad971055a1a572b46b6a517e12856af53066c19042d87a409f6859d4485
+        sourceBlobDigest: sha256:706c912b2e5755fdaff8d2a95ca3ce6fb1fff777a7aa49a8afcb0b909cc22892
         codeSamplesNamespace: speakeasy-oas-typescript-code-samples
-        codeSamplesRevisionDigest: sha256:48c48d6951802a2daef7fdf5f1f7bff87744162d88461e13dfac540c61b2b71a
+        codeSamplesRevisionDigest: sha256:9c31b17bb4388ab6732bc9336387d791a59abf73c92d316e32b6cf543d575b40
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

README.md

@@ -97,6 +97,57 @@ yarn add @tanstack/react-query react react-dom
 > [!NOTE]
 > This package is published as an ES Module (ESM) only. For applications using
 > CommonJS, use `await import("@speakeasyapi/code-samples")` to import and use this package.
+
+### Model Context Protocol (MCP) Server
+
+This SDK is also an installable MCP server where the various SDK methods are
+exposed as tools that can be invoked by AI applications.
+
+> Node.js v20 or greater is required to run the MCP server.
+
+<details>
+<summary>Claude installation steps</summary>
+
+Add the following server definition to your `claude_desktop_config.json` file:
+
+```json
+{
+  "mcpServers": {
+    "SpeakeasyCodeSamples": {
+      "command": "npx",
+      "args": [
+        "-y", "--package", "@speakeasyapi/code-samples",
+        "--",
+        "mcp", "start",
+        "--api-key", "...",
+        "--registry-url", "..."
+      ]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>Cursor installation steps</summary>
+
+Go to `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
+
+- Name: SpeakeasyCodeSamples
+- Type: `command`
+- Command:
+```sh
+npx -y --package @speakeasyapi/code-samples -- mcp start --api-key ... --registry-url ... 
+```
+
+</details>
+
+For a full list of server arguments, run:
+
+```sh
+npx -y --package @speakeasyapi/code-samples -- mcp start --help
+```
 <!-- End SDK Installation [installation] -->
 
 <!-- Start Requirements [requirements] -->

RELEASES.md

@@ -112,4 +112,14 @@ Based on:
 ### Generated
 - [typescript v2.3.0] .
 ### Releases
-- [NPM v2.3.0] https://www.npmjs.com/package/@speakeasyapi/code-samples/v/2.3.0 - .
+- [NPM v2.3.0] https://www.npmjs.com/package/@speakeasyapi/code-samples/v/2.3.0 - .
+
+## 2025-02-25 20:49:47
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.504.0 (2.529.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [typescript v2.4.0] .
+### Releases
+- [NPM v2.4.0] https://www.npmjs.com/package/@speakeasyapi/code-samples/v/2.4.0 - .

jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@speakeasyapi/code-samples",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",