feat: provide tool annotations

[SamMorrowDrums]

Closes: #306

We can provide tool annotations as part of the tool specification. This PR sets the descriptions (with ability to override translations), and the ReadOnlyHint.

I tried to make the descriptions more human readable as intended also. These are the translation file entries:

  "TOOL_ADD_ISSUE_COMMENT_USER_TITLE": "Add comment to issue",
  "TOOL_ADD_PULL_REQUEST_REVIEW_COMMENT_USER_TITLE": "Add review comment to pull request",
  "TOOL_CREATE_BRANCH_USER_TITLE": "Create branch",
  "TOOL_CREATE_ISSUE_USER_TITLE": "Open new issue",
  "TOOL_CREATE_OR_UPDATE_FILE_USER_TITLE": "Create or update file",
  "TOOL_CREATE_PULL_REQUEST_REVIEW_USER_TITLE": "Submit pull request review",
  "TOOL_CREATE_PULL_REQUEST_USER_TITLE": "Open new pull request",
  "TOOL_CREATE_REPOSITORY_USER_TITLE": "Create repository",
  "TOOL_FORK_REPOSITORY_USER_TITLE": "Fork repository",
  "TOOL_GET_CODE_SCANNING_ALERT_USER_TITLE": "Get Code Scanning alert",
  "TOOL_GET_COMMITS_USER_TITLE": "Get commit details",
  "TOOL_GET_FILE_CONTENTS_USER_TITLE": "Get file or directory contents",
  "TOOL_GET_ISSUE_COMMENTS_USER_TITLE": "Get issue comments",
  "TOOL_GET_ISSUE_USER_TITLE": "Get issue details",
  "TOOL_GET_ME_USER_TITLE": "Fetch my user profile",
  "TOOL_GET_PULL_REQUEST_COMMENTS_USER_TITLE": "Get pull request comments",
  "TOOL_GET_PULL_REQUEST_FILES_USER_TITLE": "Get pull request changed files",
  "TOOL_GET_PULL_REQUEST_REVIEWS_USER_TITLE": "Get pull request reviews",
  "TOOL_GET_PULL_REQUEST_STATUS_USER_TITLE": "Get pull request status",
  "TOOL_GET_PULL_REQUEST_USER_TITLE": "Get pull request details",
  "TOOL_GET_SECRET_SCANNING_ALERT_USER_TITLE": "Get Secret Scanning alert",
  "TOOL_LIST_BRANCHES_USER_TITLE": "List branches",
  "TOOL_LIST_CODE_SCANNING_ALERTS_USER_TITLE": "List code scanning alerts",
  "TOOL_LIST_COMMITS_USER_TITLE": "List commits",
  "TOOL_LIST_ISSUES_USER_TITLE": "List issues",
  "TOOL_LIST_PULL_REQUESTS_USER_TITLE": "List pull requests",
  "TOOL_LIST_SECRET_SCANNING_ALERTS_USER_TITLE": "List secret scanning alerts",
  "TOOL_MERGE_PULL_REQUEST_USER_TITLE": "Merge a pull request",
  "TOOL_PUSH_FILES_USER_TITLE": "Push files to repository",
  "TOOL_SEARCH_CODE_USER_TITLE": "Search code",
  "TOOL_SEARCH_ISSUES_USER_TITLE": "Search issues",
  "TOOL_SEARCH_REPOSITORIES_USER_TITLE": "Search repositories",
  "TOOL_SEARCH_USERS_USER_TITLE": "Search users",
  "TOOL_UPDATE_ISSUE_USER_TITLE": "Edit issue",
  "TOOL_UPDATE_PULL_REQUEST_BRANCH_USER_TITLE": "Update pull request branch",
  "TOOL_UPDATE_PULL_REQUEST_USER_TITLE": "Update pull request"

[Copilot]

Pull Request Overview

This PR implements tool annotations to enhance the human-readable titles and descriptions for each tool in the GitHub MCP Server. Key changes include updating the mcp-go version in third-party licenses, adding the mcp.WithToolAnnotation field in multiple tool definitions, and refining tool descriptions for clarity.

Reviewed Changes

Copilot reviewed 14 out of 15 changed files in this pull request and generated 1 comment.

File	Description
third-party-licenses.*.md	Updated mcp-go license version to v0.21.1
pkg/toolsets/toolsets.go	Added explicit annotation settings for write/read tools
pkg/github/*.go	Added mcp.WithToolAnnotation to enhance tool specifications
pkg/github/context_tools.go	Added tool annotation for GetMe with a typo in the title

Files not reviewed (1)

• go.mod: Language not supported