Native lookup has no relevance ranking or pagination
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- Meio dia
- Facilidade para iniciantes
- 45/100
Direção de pesquisa
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.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Python
- Estrelas
- 7
- Forks
- 4
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de TMHSDigital/CFX-Developer-Tools
-
help wanted severity: low tech-debt
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 45/100
TMHSDigital/CFX-Developer-Tools#79 ·
Mantenedores costumam responder em até 1 dia
-
enhancement help wanted severity: low
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Mantenedores costumam responder em até 1 dia
-
help wanted severity: low tech-debt
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Mantenedores costumam responder em até 1 dia
-
dependencies severity: low
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
enhancement severity: medium
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
Todas as issues de TMHSDigital/CFX-Developer-Tools
Issues semelhantes
-
hive size:simple
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
Mantenedores costumam responder em até 1 dia
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
painted-porch/marcus#977 ·
Mantenedores costumam responder em até 1 dia
-
llm translation
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
FAIRmat-NFDI/sand#239 ·
Mantenedores costumam responder em até 1 dia