api2ai 1.0.6 → 1.0.7

package/example-petstore/src/index.js

@@ -1,659 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * petstore-api - MCP Server
- *
- * Features:
- * - 19 API tools available
- * - Built-in Inspector at http://localhost:3000/inspector
- */
-
-import 'dotenv/config';
-import { MCPServer } from 'mcp-use/server';
-import { text, object } from 'mcp-use/server';
-import { z } from 'zod';
-import { executeRequest } from './http-client.js';
-import { toolConfigMap } from './tools-config.js';
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-const PORT = parseInt(process.env.PORT || '3000');
-const isDev = process.env.NODE_ENV !== 'production';
-
-// API configuration
-const apiConfig = {
-  baseUrl: process.env.API_BASE_URL || '/api/v3',
-  headers: {},
-};
-
-// Set up authentication headers
-if (process.env.API_KEY) {
-  apiConfig.headers['Authorization'] = `Bearer ${process.env.API_KEY}`;
-}
-
-if (process.env.API_AUTH_HEADER) {
-  const [key, ...valueParts] = process.env.API_AUTH_HEADER.split(':');
-  const value = valueParts.join(':'); // Handle values with colons
-  if (key && value) {
-    apiConfig.headers[key.trim()] = value.trim();
-  }
-}
-
-// ============================================================================
-// Server Setup
-// ============================================================================
-
-const server = new MCPServer({
-  name: 'petstore-api',
-  version: '1.0.0',
-  description: 'MCP server generated from OpenAPI specification',
-  baseUrl: process.env.MCP_URL || `http://localhost:${PORT}`,
-  allowedOrigins: isDev 
-    ? undefined  // Development: allow all origins
-    : process.env.ALLOWED_ORIGINS?.split(',').map(s => s.trim()) || [],
-});
-
-// ============================================================================
-// Tool Registrations
-// ============================================================================
-
-// Add a new pet to the store.
-server.tool(
-  {
-    name: 'addPet',
-    description: 'Add a new pet to the store.',
-    schema: z.object({
-    requestBody: z.unknown().describe('Create a new pet in the store')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('addPet');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Update an existing pet.
-server.tool(
-  {
-    name: 'updatePet',
-    description: 'Update an existing pet.',
-    schema: z.object({
-    requestBody: z.unknown().describe('Update an existent pet in the store')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('updatePet');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Finds Pets by status.
-server.tool(
-  {
-    name: 'findPetsByStatus',
-    description: 'Finds Pets by status.',
-    schema: z.object({
-    status: z.enum(['available', 'pending', 'sold']).describe('Status values that need to be considered for filter')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('findPetsByStatus');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Finds Pets by tags.
-server.tool(
-  {
-    name: 'findPetsByTags',
-    description: 'Finds Pets by tags.',
-    schema: z.object({
-    tags: z.array(z.string()).describe('Tags to filter by')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('findPetsByTags');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Find pet by ID.
-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}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Updates a pet in the store with form data.
-server.tool(
-  {
-    name: 'updatePetWithForm',
-    description: 'Updates a pet in the store with form data.',
-    schema: z.object({
-    petId: z.number().int().describe('ID of pet that needs to be updated'),
-    name: z.string().optional().describe('Name of pet that needs to be updated'),
-    status: z.string().optional().describe('Status of pet that needs to be updated')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('updatePetWithForm');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Deletes a pet.
-server.tool(
-  {
-    name: 'deletePet',
-    description: 'Deletes a pet.',
-    schema: z.object({
-    api_key: z.string().optional(),
-    petId: z.number().int().describe('Pet id to delete')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('deletePet');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Uploads an image.
-server.tool(
-  {
-    name: 'uploadFile',
-    description: 'Uploads an image.',
-    schema: z.object({
-    petId: z.number().int().describe('ID of pet to update'),
-    additionalMetadata: z.string().optional().describe('Additional Metadata'),
-    requestBody: z.string().optional().describe('Request body')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('uploadFile');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Returns pet inventories by status.
-server.tool(
-  {
-    name: 'getInventory',
-    description: 'Returns pet inventories by status.',
-    schema: z.object({}),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('getInventory');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Place an order for a pet.
-server.tool(
-  {
-    name: 'placeOrder',
-    description: 'Place an order for a pet.',
-    schema: z.object({
-    requestBody: z.unknown().optional().describe('Request body')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('placeOrder');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Find purchase order by ID.
-server.tool(
-  {
-    name: 'getOrderById',
-    description: 'Find purchase order by ID.',
-    schema: z.object({
-    orderId: z.number().int().describe('ID of order that needs to be fetched')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('getOrderById');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Delete purchase order by identifier.
-server.tool(
-  {
-    name: 'deleteOrder',
-    description: 'Delete purchase order by identifier.',
-    schema: z.object({
-    orderId: z.number().int().describe('ID of the order that needs to be deleted')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('deleteOrder');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Create user.
-server.tool(
-  {
-    name: 'createUser',
-    description: 'Create user.',
-    schema: z.object({
-    requestBody: z.unknown().optional().describe('Created user object')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('createUser');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Creates list of users with given input array.
-server.tool(
-  {
-    name: 'createUsersWithListInput',
-    description: 'Creates list of users with given input array.',
-    schema: z.object({
-    requestBody: z.array(z.unknown()).optional().describe('Request body')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('createUsersWithListInput');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Logs user into the system.
-server.tool(
-  {
-    name: 'loginUser',
-    description: 'Logs user into the system.',
-    schema: z.object({
-    username: z.string().optional().describe('The user name for login'),
-    password: z.string().optional().describe('The password for login in clear text')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('loginUser');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Logs out current logged in user session.
-server.tool(
-  {
-    name: 'logoutUser',
-    description: 'Logs out current logged in user session.',
-    schema: z.object({}),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('logoutUser');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Get user by user name.
-server.tool(
-  {
-    name: 'getUserByName',
-    description: 'Get user by user name.',
-    schema: z.object({
-    username: z.string().describe('The name that needs to be fetched. Use user1 for testing')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('getUserByName');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Update user resource.
-server.tool(
-  {
-    name: 'updateUser',
-    description: 'Update user resource.',
-    schema: z.object({
-    username: z.string().describe('name that need to be deleted'),
-    requestBody: z.unknown().optional().describe('Update an existent user in the store')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('updateUser');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// Delete user resource.
-server.tool(
-  {
-    name: 'deleteUser',
-    description: 'Delete user resource.',
-    schema: z.object({
-    username: z.string().describe('The name that needs to be deleted')
-  }),
-  },
-  async (params) => {
-    const toolConfig = toolConfigMap.get('deleteUser');
-    const result = await executeRequest(toolConfig, params, apiConfig);
-
-    if (!result.ok) {
-      return text(`Error: ${result.status} ${result.statusText}\n${
-        typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2)
-      }`);
-    }
-
-    // Return MCP content based on response type
-    if (typeof result.data === 'string') {
-      return text(result.data);
-    } else if (typeof result.data === 'object' && result.data !== null) {
-      return object(result.data);
-    } else {
-      return text(String(result.data));
-    }
-  }
-);
-
-// ============================================================================
-// Start Server
-// ============================================================================
-
-server.listen(PORT);
-
-console.log(`
-🚀 petstore-api MCP Server Started
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📍 Server:    http://localhost:${PORT}
-🔍 Inspector: http://localhost:${PORT}/inspector
-📡 MCP:       http://localhost:${PORT}/mcp
-🔄 SSE:       http://localhost:${PORT}/sse
-
-🛠️  Tools Available: 19
-   • addPet
-   • updatePet
-   • findPetsByStatus
-   • findPetsByTags
-   • getPetById
-   ... and 14 more
-Environment: ${isDev ? 'Development' : 'Production'}
-API Base:    ${apiConfig.baseUrl || 'Not configured'}
-`);