feat: Add tool annotations for improved LLM tool understanding #27
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds MCP tool annotations (
readOnlyHint,openWorldHint,title) to all 4 tools to help LLMs better understand tool behavior and make safer decisions about tool execution.Changes
readOnlyHint: trueto read-only tools (search, get content, get comments)openWorldHint: trueto all tools (they interact with external Xiaohongshu API)titleannotations@modelcontextprotocol/sdkfrom^1.9.0to1.11.0for annotation supportstdioLogger.tsfor SDK compatibilityWhy This Matters
Testing
npm run build)tools/listreturns annotations for all 4 toolsBefore/After
Before:
{ "name": "search_notes", "description": "根据关键词搜索笔记" }After:
{ "name": "search_notes", "description": "根据关键词搜索笔记", "annotations": { "title": "Search Notes", "readOnlyHint": true, "openWorldHint": true } }🤖 Generated with Claude Code