Native lookup has no relevance ranking or pagination
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 3/5
- 預估耗時
- 半天
- 新手友好度
- 45/100
研究方向
Start in mcp-server/tools/natives.py, where lookup_native applies an unranked substring filter and _format_results caps output at show_limit = 25, then check the lookup_native_tool signature in mcp-server/server.py. Deprecation parsing lives in .github/scripts/transform_natives.py near line 197. There is no test suite, so verify by running the MCP server and calling the lookup. Done means exact-name matches rank first, limit and offset page results, and deprecated natives expose a replacement.
由索引模型根據 Issue 內容生成。
描述
Summary
lookup_native_tool returns matches in file (alphabetical) order and cuts them at 25 with no offset. Broad queries hide the most relevant natives, deprecated natives do not expose their replacement in a structured way, and the output is prose only.
Where
mcp-server/tools/natives.py:46-62(lookup_native, unranked substring filter)mcp-server/tools/natives.py:104-141(_format_results,show_limit = 25)mcp-server/server.py:51-66(lookup_native_toolsignature).github/scripts/transform_natives.py:197(deprecation detection)
Details
lookup_native("vehicle")returns "Found 1077 native(s)" and shows only the first 25 alphabetical names, followed by "Narrow your search". There is nolimitoroffset.- A name match ranks the same as a description match.
- For deprecated natives the replacement appears only as a markdown link inside the description text (for example
use [HINT_SCRIPT_AUDIO_BANK](#\_0xFB38...)), with noreplaced_byfield.
SCREAMING_SNAKE name matching is tracked in "lookup_native returns nothing for canonical SCREAMING_SNAKE native names".
Impact
For partial or broad queries the native the agent wants is often past the cutoff and unreachable without guessing a narrower string. Agents cannot reliably follow a deprecation to its replacement or parse results.
Suggested fix
- Score matches: exact name, then name prefix, then name substring, then category, then description; sort by score.
- Add
limit(default 25, max 100) andoffsetparameters. - In
transform_natives.py, extract the linked replacement into areplaced_byfield and render it as "Use X instead". - Add an optional
format="json"that returns the raw records.
Acceptance criteria
- An exact-name query lists that native first even when many others match the description.
-
offsetpages through results beyond the first 25. - Deprecated natives with a known replacement show it.
-
format="json"returns parseable records.
Getting started
- Relevant files:
mcp-server/tools/natives.py,mcp-server/server.py,.github/scripts/transform_natives.py - How to run checks: there is no test suite yet; run the MCP server with
cd mcp-server && pip install -r requirements.txt && python server.py, and CI checks live in.github/workflows/validate.yml - Related docs:
skills/native-functions/SKILL.md
Filed by repo-audit/full-audit at 701824d. Severity: medium. Effort: S. audit-key: enhancement|mcp-server/tools/natives.py|ranking
- 主要語言
- Python
- 星號
- 7
- 分支
- 4
- PR 合併指標
- 30 天內沒有已合併 PR
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
TMHSDigital/CFX-Developer-Tools 的其他 Issue
-
help wanted severity: low tech-debt
難度 3/5 1-2 天 新手友好度 45/100
TMHSDigital/CFX-Developer-Tools#79 ·
維護者通常 1 天內回覆
-
enhancement help wanted severity: low
難度 3/5 1-2 天 新手友好度 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
維護者通常 1 天內回覆
-
help wanted severity: low tech-debt
難度 4/5 3-5 天 新手友好度 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
維護者通常 1 天內回覆
-
dependencies severity: low
難度 3/5 1-2 天 新手友好度 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 則留言 ·
維護者通常 1 天內回覆
-
enhancement severity: medium
難度 3/5 1-2 天 新手友好度 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 則留言 ·
維護者通常 1 天內回覆
查看 TMHSDigital/CFX-Developer-Tools 的全部 Issue
相似的 Issue
-
hive size:simple
難度 2/5 1-3 小時 新手友好度 78/100
維護者通常 1 天內回覆
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)未關閉
難度 2/5 1-3 小時 新手友好度 68/100
-
難度 2/5 1-3 小時 新手友好度 70/100
painted-porch/marcus#977 ·
維護者通常 1 天內回覆
-
llm translation
難度 2/5 1-3 小時 新手友好度 82/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 78/100
FAIRmat-NFDI/sand#239 ·
維護者通常 1 天內回覆