api2ai 1.0.3 → 1.0.6

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node generate-mcp-use-server.js:*)"
+    ]
+  }
+}

package/README.md

@@ -101,9 +101,39 @@ my-mcp-server/
 ├── package.json
 ├── README.md         # Generated documentation
 └── src/
-    ├── index.js      # Main server with tool registrations
-    ├── http-client.js # HTTP utilities
-    └── tools-config.js # Tool configurations
+    ├── index.js        # Main server with MCP tool registrations
+    ├── http-client.js  # HTTP utilities for API calls
+    └── tools-config.js # Tool configurations from OpenAPI spec
+```
+
+### Tool Registration Format
+
+Each API endpoint is converted into a proper MCP tool:
+
+```javascript
+// Example generated tool
+server.tool(
+  {
+    name: 'getPetById',
+    description: 'Find pet by ID',
+    schema: z.object({
+      petId: z.number().int().describe('ID of pet to return'),
+    }),
+  },
+  async (params) => {
+    const toolConfig = toolConfigMap.get('getPetById');
+    const result = await executeRequest(toolConfig, params, apiConfig);
+
+    if (!result.ok) {
+      return text(\`Error: \${result.status} \${result.statusText}\`);
+    }
+
+    // Returns MCP content types (text or object)
+    return typeof result.data === 'object'
+      ? object(result.data)
+      : text(result.data);
+  }
+);
 ```
 
 ## Generated Server Features

package/example-petstore/README.md

@@ -108,9 +108,32 @@ petstore-api/
 ├── package.json      # Dependencies
 ├── README.md         # This file
 └── src/
-    ├── index.js      # Main server with tool registrations
-    ├── http-client.js # HTTP utilities for API calls
-    └── tools-config.js # Tool configurations from OpenAPI
+    ├── index.js        # Main server with MCP tool registrations
+    ├── http-client.js  # HTTP utilities for API calls
+    └── tools-config.js # Tool configurations from OpenAPI spec
+```
+
+## How It Works
+
+Each tool is registered using the proper MCP format:
+
+```javascript
+server.tool(
+  {
+    name: 'getPetById',
+    description: 'Find pet by ID',
+    schema: z.object({
+      petId: z.number().int().describe('ID of pet to return'),
+    }),
+  },
+  async (params) => {
+    // Fetch data from the API
+    const result = await executeRequest(toolConfig, params, apiConfig);
+
+    // Return MCP content (text or object)
+    return result.ok ? object(result.data) : text(`Error: ${result.status}`);
+  }
+);
 ```
 
 ## Production Deployment
@@ -137,7 +160,7 @@ pm2 start src/index.js --name petstore-api
 ## Source
 
 - **OpenAPI Spec**: `https://petstore3.swagger.io/api/v3/openapi.json`
-- **Generated**: 2025-12-30T23:36:57.107Z
+- **Generated**: 2025-12-31T01:39:23.989Z
 - **Framework**: [mcp-use](https://mcp-use.com)
 
 ## License