feat: Add tool annotations for improved LLM tool understanding

[bryankthompson]

Summary

Adds MCP tool annotations (readOnlyHint, destructiveHint, openWorldHint, title) to all tools to help LLMs better understand tool behavior and make safer decisions about tool execution.

Changes

• BaseTool class: Added annotations abstract property and updated register() to pass annotations to server.tool()
• CreateUiTool: destructiveHint: true, openWorldHint: true (opens browser, creates/modifies files)
• FetchUiTool: readOnlyHint: true, openWorldHint: true (read-only API call)
• LogoSearchTool: destructiveHint: true, openWorldHint: true (writes to filesystem)
• RefineUiTool: destructiveHint: true, openWorldHint: true (modifies existing components)
• MCP SDK: Bumped from ^1.8.0 to ^1.25.1 for annotation support

Why This Matters

• Annotations provide semantic metadata that helps LLMs understand tool behavior
• LLMs can make better decisions about when to use tools and in what order
• Enables safer tool execution by distinguishing read-only from destructive operations
• openWorldHint indicates tools interact with external services (21st.dev, SVGL API)

Testing

• Server builds successfully (npm run build)
• Tests pass (npm run test)
• tools/list returns annotations in response
• Annotation values match actual tool behavior

Before/After

Before:

{
  "name": "21st_magic_component_inspiration",
  "description": "...",
  "inputSchema": {...}
}

After:

{
  "name": "21st_magic_component_inspiration",
  "description": "...",
  "inputSchema": {...},
  "annotations": {
    "title": "Fetch UI Inspiration",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}

🤖 Generated with Claude Code

[bryankthompson]

Friendly ping! 👋 Just checking if this PR is still on your radar. Happy to address any feedback or make adjustments if needed. No rush - just wanted to make sure it didn't slip through the cracks.