Prompts MCP Server

Instructions

Implementation Reference

• src/tools.ts:235-259 (handler)

  Main handler function for the 'list_prompts' tool. Fetches prompts from file operations, handles empty list, formats the list, and returns as MCP CallToolResult.

  private async handleListPrompts(): Promise<CallToolResult> {
    const prompts = await this.fileOps.listPrompts();
    
    if (prompts.length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: 'No prompts available',
          } as TextContent,
        ],
      };
    }
  
    const text = this.formatPromptsList(prompts);
    
    return {
      content: [
        {
          type: 'text',
          text,
        } as TextContent,
      ],
    };
  }

• src/tools.ts:59-66 (schema)

  Tool schema definition including name, description, and empty input schema (no parameters required).

  {
    name: 'list_prompts',
    description: 'List all available prompts',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/fileOperations.ts:37-45 (helper)

  Core helper function that lists all prompts by initializing and querying the prompt cache.

  async listPrompts(): Promise<PromptInfo[]> {
    // Initialize cache and file watcher if not already done
    if (this.cache.isEmpty()) {
      await this.cache.initializeCache();
      this.cache.initializeFileWatcher();
    }
    
    return this.cache.getAllPrompts();
  }

• src/tools.ts:142-143 (registration)

  Tool registration in the switch dispatcher within handleToolCall method.

  case 'list_prompts':
    return await this.handleListPrompts();

• src/tools.ts:330-347 (helper)

  Helper function to format the list of prompts into a readable markdown display.

  private formatPromptsList(prompts: PromptInfo[]): string {
    const formatPrompt = (prompt: PromptInfo): string => {
      let output = `## ${prompt.name}\n`;
      
      if (Object.keys(prompt.metadata).length > 0) {
        output += '**Metadata:**\n';
        Object.entries(prompt.metadata).forEach(([key, value]) => {
          output += `- ${key}: ${value}\n`;
        });
        output += '\n';
      }
      
      output += `**Preview:** ${prompt.preview}\n`;
      return output;
    };
  
    return `# Available Prompts\n\n${prompts.map(formatPrompt).join('\n---\n\n')}`;
  }