Native lookup has no relevance ranking or pagination
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 3/5
- Tiempo estimado
- Medio día
- Aptitud para principiantes
- 45/100
Línea de trabajo
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.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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
- Lenguaje dominante
- Python
- Estrellas
- 7
- Forks
- 4
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de TMHSDigital/CFX-Developer-Tools
-
help wanted severity: low tech-debt
Dificultad 3/5 1-2 días Aptitud para principiantes 45/100
TMHSDigital/CFX-Developer-Tools#79 ·
Los mantenedores suelen responder en 1 día
-
enhancement help wanted severity: low
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Los mantenedores suelen responder en 1 día
-
help wanted severity: low tech-debt
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Los mantenedores suelen responder en 1 día
-
dependencies severity: low
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
enhancement severity: medium
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 comentario ·
Los mantenedores suelen responder en 1 día
Todos los issues de TMHSDigital/CFX-Developer-Tools
Issues similares
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
llm translation
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
FAIRmat-NFDI/sand#239 ·
Los mantenedores suelen responder en 1 día
-
bug P2
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
coco-research/coco#539 ·
Los mantenedores suelen responder en 1 día
-
dependencies
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
JustBeanie/hass-volcano-hybrid#34 ·
Los mantenedores suelen responder en 1 día