Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

ToolSearchのランキングを修正しました。MCPツール名を貼り付けた際に、説明文でマッチする類似ツールではなく、実際のツールが上位に表示されるようになりました。

原文（英語） ​

Fixed ToolSearch ranking so pasted MCP tool names surface the actual tool instead of description-matching siblings

概要 ​

MCPツール名をToolSearchに貼り付けて検索した場合、正確なツール名ではなく説明文のキーワードでマッチする類似ツールが先に表示される問題がありました。例えば mcp__github__list_issues と入力したとき、mcp__github__search_issues のような類似ツールが上位になることがありました。今回の修正でToolSearchが完全一致のツール名を優先的に上位に表示するようになります。

基本的な使い方 ​

# MCPツール名でToolSearchを使う場面

# 修正前: 「mcp__github__list_issues」と入力したとき
# → mcp__github__search_issues (description: "search and list issues...")
# → mcp__github__list_issues  ← 目的のツールが下位

# 修正後:
# → mcp__github__list_issues  ← 目的のツールが最上位
# → mcp__github__search_issues (類似ツールは下位)

実践例 ​

GitHubのMCPツールを名前で検索する ​

# CLAUDE.mdやプロンプトからMCPツール名をコピーして検索する場合

# 例: ドキュメントに記載されているツール名をコピー
mcp__github__create_pull_request

# このツール名をToolSearchに貼り付けると:
# 修正後: create_pull_request ツールが最上位に表示される
# 修正前: "pull request" を含む他のツール（list_pull_requests等）が先に表示されることがあった

MCPツール名の完全一致検索 ​

python
# MCPクライアントでのツール検索の概念的な例

# 修正前のランキングアルゴリズム:
# 1. 説明文のキーワードマッチ（重み: 高）
# 2. ツール名のマッチ（重み: 低）
# → "list" を含む説明を持つツールが "list_issues" より上位になることがあった

# 修正後のランキングアルゴリズム:
# 1. ツール名の完全一致（重み: 最高）
# 2. ツール名の部分一致（重み: 高）
# 3. 説明文のキーワードマッチ（重み: 低）
# → 正確なツール名が常に最上位に表示される

MCPサーバーの設定と活用 ​

json
// ~/.claude/settings.json でのMCPサーバー設定例
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  }
}
# 設定後のMCPツール一覧の例:
# mcp__github__list_issues
# mcp__github__create_issue
# mcp__github__get_issue
# mcp__github__list_pull_requests
# mcp__filesystem__read_file
# mcp__filesystem__write_file
# mcp__filesystem__list_directory

# 修正後: これらのツール名を正確にToolSearchに入力すると
# 期待通りのツールが最上位に表示される

CLAUDE.mdでのツール参照 ​

markdown
<!-- CLAUDE.md でMCPツールを指定する場合 -->
# ツール使用の指針

特定のタスクでは以下のMCPツールを使用してください:
- リポジトリ情報取得: `mcp__github__get_repository`
- Issue作成: `mcp__github__create_issue`
- ファイル読み込み: `mcp__filesystem__read_file`

<!-- これらのツール名をClaudeが検索する際、修正後は正確なツールが見つかる -->

注意点 ​

  • この修正はToolSearchの内部ランキングアルゴリズムの改善です
  • MCPツールの動作自体は変わりません
  • 多くのMCPツールがある環境ほど、この改善の効果が大きくなります
  • ツール名の完全一致が最優先されますが、曖昧な検索クエリの場合は説明文マッチも引き続き機能します
  • Claude CodeがMCPツールを自律的に選択する際にも、より正確なツール選択が期待できます

関連情報 ​