Loading ToolBench
Pure MCP server providing library documentation access for AI assistants. Connects to documentation-platform database to expose 12 tools for searching, retrieving, and managing library documentation.
Server has 12 well-organized tools with consistent naming (verb_noun pattern) and detailed descriptions in Traditional Chinese. All tools are READ_ONLY and properly registered via Spring AI's @Tool annotation. However, input schemas lack explicit type definitions in the visible code, parameter types are inferred from method signatures rather than declared in JSON Schema format. Descriptions are comprehensive (100-300 chars) but include Chinese text that may reduce LLM parsing efficiency. Output schemas are not documented. Error handling and recovery guidance are absent from tool definitions.
搜尋特定的 API 參考文件。 使用時機： - 當需要查找特定類別或方法的文件時 - 當需要了解某個 API 的用法和參數時 - 當需要查找特定註解或介面的說明時 回傳：包含該 API 的文件列表，包含標題、路徑和相關片段。
取得函式庫的程式碼範例。 使用時機： - 當需要查看特定函式庫的使用範例時 - 當需要特定程式語言的範例程式碼時 - 當想學習如何使用某個 API 時 回傳：程式碼範例列表，包含程式語言、程式碼內容及說明。
取得文件完整內容。 使用時機： - 當透過 search_docs 或 semantic_search 找到相關文件後 - 當需要閱讀文件的完整內容時 - 當需要查看文件中的程式碼範例時 回傳：文件完整內容，包含標題、路徑、內容及程式碼範例。
取得文件庫的目錄結構（Table of Contents）。 使用時機： - 當需要了解文件的整體結構時 - 當需要瀏覽特定主題的相關文件時 - 當需要幫助使用者找到特定文件時 回傳：樹狀目錄結構，包含文件標題、路徑和層級。
取得版本遷移指南。 使用時機： - 當需要從一個版本升級到另一個版本時 - 當想了解版本間的破壞性變更時 - 當需要查看升級步驟和注意事項時 回傳：遷移相關文件列表，包含升級指南、破壞性變更說明等。
查找與指定文件相關的其他文件。 使用時機： - 當使用者閱讀某篇文件後想看相關內容時 - 當需要探索特定主題的更多資料時 - 當需要建立文件間的關聯時 回傳：相關文件列表，包含標題、路徑和相似度分數。
Input schemas lack explicit JSON Schema type declarations. Parameter types (string, integer, boolean, number) are inferred from Java method signatures but not formally declared in MCP schema format. Spring AI's @ToolParam annotation does not expose full JSON Schema with 'type' field.
Output schemas are not documented. Tools return DTOs (ListLibrariesResult, ResolveLibraryResult, etc.) but the structure of these objects is not visible in the provided code. LLMs cannot plan downstream tool calls without knowing what fields to expect.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
取得函式庫的同步狀態與歷史記錄。 使用時機： - 當需要查看文件同步是否正在進行中時 - 當需要查詢最近的同步結果（成功或失敗）時 - 當需要了解已處理的文件數量和區塊數量時 回傳：同步狀態（是否執行中）、最新同步記錄、最近的同步歷史。
列出所有可用的文件函式庫。 使用時機： - 當需要知道有哪些函式庫可以查詢時 - 當需要探索特定分類的函式庫時 回傳：函式庫列表，包含名稱、描述、分類等資訊。
列出指定函式庫的所有可用版本。 使用時機： - 當需要查看某個函式庫有哪些版本可用時 - 當需要協助使用者選擇適合的版本時 - 當需要了解版本狀態（活躍、已棄用、EOL）時 回傳：版本列表，包含版本號、狀態、發布日期等資訊。
解析函式庫名稱和版本，取得函式庫 ID 和版本資訊。 使用時機： - 在搜尋或取得文件內容前，需要先解析函式庫 - 當需要確認函式庫是否存在及其可用版本時 參數： - library: 函式庫名稱（必填），如 'spring-boot'、'react' - version: 版本號（可選），如 '3.2.0'，不指定則使用最新版本 回傳：函式庫 ID、解析後的版本號、版本 ID。
在指定函式庫的文件中搜尋關鍵字。 使用時機： - 當需要查找特定的 API、類別或方法名稱時 - 當需要搜尋特定的錯誤訊息或術語時 - 當知道確切的關鍵字要搜尋時 注意：此工具使用全文檢索，適合精確的關鍵字搜尋。 若需要自然語言查詢，請使用 semantic_search。 回傳：匹配的文件列表，包含標題、路徑和內容摘要。
使用自然語言語意搜尋文件。 使用時機： - 當用自然語言描述問題或需求時 - 當不確定精確的關鍵字時 - 當想找「如何做某事」的說明時 - 當需要找概念相關但用詞不同的內容時 注意：此工具使用向量相似度搜尋，適合語意查詢。 若知道精確的關鍵字，請使用 search_docs 以獲得更準確的結果。 回傳：語意相似的文件區塊列表，包含相似度分數。
Descriptions are in Traditional Chinese, which may reduce parsing efficiency for English-language LLMs and violate the principle of matching the chat data model. Tool descriptions should be in English for maximum LLM compatibility.
No error handling or recovery guidance in tool definitions. Tools do not document what errors can occur, whether they are retryable, or what the LLM should do next (e.g., 'If library not found, call list_libraries first').
Parameter constraints are documented in descriptions but not enforced via schema enums or patterns. E.g., 'threshold' in semantic_search accepts 0-1 but this is stated in text, not as a JSON Schema constraint. LLMs may pass invalid values.