Repository navigation
v0.3.0 — pagination, mock tests, evaluations
Closes four remaining gaps against the MCP server best-practices checklist.
Pagination
- New
paginationmodule with a uniformpaginationblock (page, per_page, total, total_pages, next_page, has_more) extracted frompython-gitlablist results. gitlab_list_pipelines,gitlab_list_branches,gitlab_list_tags,gitlab_list_merge_requests,gitlab_list_repository_treenow takepageand return the pagination block.- Markdown formatters include a footer line with a next-page hint.
Docstring Examples
- Added
Examples:section to 14 tool docstrings — 'Use when … → args' / 'Don't use when … use <other_tool> instead'. Improves LLM tool-picking accuracy.
Mock tests
- New
tests/test_tools_mocked.pywith 7 tests using theresponseslibrary — happy paths (JSON + markdown), pagination, 401, 404, missing env, project info. Guards against shape regressions inpython-gitlabupgrades.
Evaluations
evaluations/questions.xml— 22 tool-picking QA pairs (one per tool) for agent evaluation.evaluations/README.md— runner snippet + fixture-based evaluation notes.
Total: 13 tests (6 smoke + 7 mock). Ruff clean. 23 tools, 1 pagination helper, 2 test files.