Swagger MCP Server

Instructions

Implementation Reference

• src/tools/template-manager-tool.ts:175-219 (handler)

  The main handler function for the 'template-get' tool. It fetches the template by ID using TemplateManager and returns a standardized JSON response with success/error status.

  private async getTemplate(params: { id: string }): Promise<any> {
    try {
      const template = this.templateManager.getTemplate(params.id);
      
      if (!template) {
        return {
          content: [
            {
              type: 'text' as const,
              text: JSON.stringify({
                success: false,
                error: `Template not found with ID: ${params.id}`
              }, null, 2)
            }
          ]
        };
      }
      
      return {
        content: [
          {
            type: 'text' as const,
            text: JSON.stringify({
              success: true,
              template
            }, null, 2)
          }
        ]
      };
    } catch (error) {
      console.error('[TemplateManagerTool] 获取模板失败:', error);
      
      return {
        content: [
          {
            type: 'text' as const,
            text: JSON.stringify({
              success: false,
              error: error instanceof Error ? error.message : String(error)
            }, null, 2)
          }
        ]
      };
    }
  }

• src/tools/template-manager-tool.ts:57-67 (registration)

  Registers the 'template-get' tool with the MCP server, including name, description, input schema, and handler reference.

  // 注册获取单个模板工具
  server.tool(
    TEMPLATE_GET_TOOL_NAME,
    TEMPLATE_GET_TOOL_DESCRIPTION,
    {
      id: z.string().describe('Template ID'),
    },
    async (params) => {
      return await this.getTemplate(params);
    }
  );

• src/tools/template-manager-tool.ts:61-63 (schema)

  Zod input schema defining the required 'id' parameter as a string.

  {
    id: z.string().describe('Template ID'),
  },

• src/tools/template-manager-tool.ts:13-14 (helper)

  Constants defining the tool name and description used in registration.

  const TEMPLATE_GET_TOOL_NAME = 'template-get';
  const TEMPLATE_GET_TOOL_DESCRIPTION = 'Get specific template content';

• src/templates/template-manager.ts:206-208 (helper)

  Underlying helper method in TemplateManager that finds and returns a template by ID from loaded templates.

  getTemplate(id: string): Template | undefined {
    return this.getAllTemplates().find(template => template.id === id);
  }