Skip to content

v0.3.0 — pagination, mock tests, evaluations

Choose a tag to compare

@mshegolev mshegolev released this 17 Apr 12:15
· 25 commits to main since this release

Closes four remaining gaps against the MCP server best-practices checklist.

Pagination

  • New pagination module with a uniform pagination block (page, per_page, total, total_pages, next_page, has_more) extracted from python-gitlab list results.
  • gitlab_list_pipelines, gitlab_list_branches, gitlab_list_tags, gitlab_list_merge_requests, gitlab_list_repository_tree now take page and 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.py with 7 tests using the responses library — happy paths (JSON + markdown), pagination, 401, 404, missing env, project info. Guards against shape regressions in python-gitlab upgrades.

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.