feat: Add tool annotations for improved LLM tool understanding

Add readOnlyHint and destructiveHint annotations to all tools
to help LLMs better understand tool behavior and make safer decisions.

Changes:
- Added readOnlyHint: true to 9 read-only tools (get_component,
  get_component_demo, list_components, get_component_metadata,
  get_directory_structure, get_block, list_blocks, list_themes, get_theme)
- Added destructiveHint: true to apply_theme (modifies filesystem)
- Added title annotations for human-readable display

This improves tool safety metadata for MCP clients.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: web-flow

src/server/handler.ts

@@ -111,6 +111,10 @@ export const setupHandlers = (server: Server): void => {
               },
               required: ['componentName'],
             },
+            annotations: {
+              title: "Get Component",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'get_component_demo',
@@ -125,6 +129,10 @@ export const setupHandlers = (server: Server): void => {
               },
               required: ['componentName'],
             },
+            annotations: {
+              title: "Get Component Demo",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'list_components',
@@ -133,6 +141,10 @@ export const setupHandlers = (server: Server): void => {
               type: 'object',
               properties: {},
             },
+            annotations: {
+              title: "List Components",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'get_component_metadata',
@@ -147,6 +159,10 @@ export const setupHandlers = (server: Server): void => {
               },
               required: ['componentName'],
             },
+            annotations: {
+              title: "Get Component Metadata",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'get_directory_structure',
@@ -172,6 +188,10 @@ export const setupHandlers = (server: Server): void => {
                 },
               },
             },
+            annotations: {
+              title: "Get Directory Structure",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'get_block',
@@ -190,6 +210,10 @@ export const setupHandlers = (server: Server): void => {
               },
               required: ['blockName'],
             },
+            annotations: {
+              title: "Get Block",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'list_blocks',
@@ -203,6 +227,10 @@ export const setupHandlers = (server: Server): void => {
                 },
               },
             },
+            annotations: {
+              title: "List Blocks",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'apply_theme',
@@ -229,6 +257,10 @@ export const setupHandlers = (server: Server): void => {
                 },
               },
             },
+            annotations: {
+              title: "Apply Theme",
+              destructiveHint: true,
+            },
           },
           {
             name: 'list_themes',
@@ -237,6 +269,10 @@ export const setupHandlers = (server: Server): void => {
               type: 'object',
               properties: {},
             },
+            annotations: {
+              title: "List Themes",
+              readOnlyHint: true,
+            },
           },
           {
             name: 'get_theme',
@@ -251,6 +287,10 @@ export const setupHandlers = (server: Server): void => {
               },
               required: ['themeName'],
             },
+            annotations: {
+              title: "Get Theme",
+              readOnlyHint: true,
+            },
           },
         ];