specrun 1.0.0 → 1.1.0

package/README.md

@@ -21,6 +21,7 @@ Built with [FastMCP](https://www.npmjs.com/package/fastmcp) for TypeScript.
 - **Multiple Transports**: Support for stdio and HTTP streaming
 - **Built-in Debugging**: List command to see loaded specs and tools
 - **MCP Prompts**: Built-in prompts for listing tools, generating inputs, and explaining schemas
+- **Agent**: configured agent for using SpecRun tools to explore and operate APIs in a guided way ([`.github/agents/specrun.agent.md`](.github/agents/specrun.agent.md))
 
 ## Quick Start
 
@@ -91,6 +92,31 @@ Otherwise:
 }
 ```
 
+or with specific Node version:
+
+```json
+{
+  "mcpServers": {
+    "specrun": {
+      "command": "/Users/YOUR_USER_NAME/.local/bin/mcp-npx-node22",
+      "args": ["specrun@latest", "--specs", "/absolute/path/to/your/specs"],
+      "type": "stdio"
+    }
+  }
+}
+```
+
+The `mcp-npx-node22` script file uses nvm to run specrun with Node.js 22.14.0, ensuring compatibility regardless of the default Node version on your system.:
+
+```bash
+#!/bin/bash
+# Set the PATH to include NVM's Node.js v22.14.0 installation
+export PATH="/Users/Pavlo_Piga/.nvm/versions/node/v22.14.0/bin:$PATH"
+
+# Execute npx with all passed arguments
+exec npx "$@"
+```
+
 ## 💻 CLI Usage
 
 ### 🚀 Start the server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrun",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "An MCP server that converts OpenAPI specifications to MCP tools - scan a folder for spec files and automatically generate corresponding tools",
   "main": "dist/index.js",
   "bin": {
@@ -23,8 +23,9 @@
     "tools",
     "spec",
     "fastmcp",
-    "runner",
-    "generator"
+    "run",
+    "execute",
+    "generate"
   ],
   "author": "Pavel Piha",
   "types": "dist/index.d.ts",

package/specs/cars.swagger.json

@@ -7,7 +7,7 @@
   },
   "servers": [
     {
-      "url": "https://api-server.placeholder"
+      "url": "https://api.example.com"
     }
   ],
   "paths": {
@@ -52,7 +52,11 @@
             "application/json": {
               "schema": {
                 "type": "object",
-                "required": ["make", "model", "year"],
+                "required": [
+                  "make",
+                  "model",
+                  "year"
+                ],
                 "properties": {
                   "make": {
                     "type": "string",
@@ -70,7 +74,11 @@
                   "status": {
                     "type": "string",
                     "description": "car status in the catalog",
-                    "enum": ["available", "reserved", "sold"]
+                    "enum": [
+                      "available",
+                      "reserved",
+                      "sold"
+                    ]
                   }
                 }
               }
@@ -101,5 +109,5 @@
       }
     }
   },
-  "x-base-url": "https://api-server.placeholder"
+  "x-base-url": "https://api.example.com"
 }

package/specs/github.yaml

@@ -4,7 +4,7 @@ info:
   version: 1.0.0
   description: A subset of the GitHub REST API for demonstration
 servers:
-  - url: https://api.github.com
+  - url: https://api.example.com
 paths:
   /user:
     get:
@@ -18,25 +18,32 @@ paths:
           description: Requires authentication
       security:
         - bearerAuth: []
-
   /user/repos:
     get:
       operationId: listUserRepos
       summary: List repositories for the authenticated user
-      description: Lists repositories that the authenticated user has explicit permission to access
+      description: Lists repositories that the authenticated user has explicit
+        permission to access
       parameters:
         - name: type
           in: query
           schema:
             type: string
-            enum: [all, owner, member]
+            enum:
+              - all
+              - owner
+              - member
             default: all
           description: Type of repositories to list
         - name: sort
           in: query
           schema:
             type: string
-            enum: [created, updated, pushed, full_name]
+            enum:
+              - created
+              - updated
+              - pushed
+              - full_name
             default: full_name
           description: Sort order
         - name: per_page
@@ -54,7 +61,6 @@ paths:
           description: Requires authentication
       security:
         - bearerAuth: []
-
   /repos/{owner}/{repo}:
     get:
       operationId: getRepository
@@ -78,7 +84,6 @@ paths:
           description: Repository information
         "404":
           description: Repository not found
-
   /repos/{owner}/{repo}/issues:
     get:
       operationId: listRepoIssues
@@ -101,7 +106,10 @@ paths:
           in: query
           schema:
             type: string
-            enum: [open, closed, all]
+            enum:
+              - open
+              - closed
+              - all
             default: open
           description: Issue state
         - name: labels
@@ -112,7 +120,6 @@ paths:
       responses:
         "200":
           description: List of issues
-
     post:
       operationId: createIssue
       summary: Create an issue
@@ -136,7 +143,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [title]
+              required:
+                - title
               properties:
                 title:
                   type: string
@@ -156,9 +164,9 @@ paths:
           description: Validation failed
       security:
         - bearerAuth: []
-
 components:
   securitySchemes:
     bearerAuth:
       type: http
       scheme: bearer
+x-base-url: https://api.example.com