Skip to content

Releases: ejfkdev/zread

v2.2.1

24 May 16:16
9ef72db

Choose a tag to compare

What's Changed

Fix: MCP Tool Return Type Schemas

All MCP tools now use TypedDict return types, generating precise JSON schemas instead of generic additionalProperties: true or wrapped {"result": ...} formats.

Schema improvements:

  • get_repo_info → schema with exact fields: url, name, description, language, topics, stars, status, repo_id, wiki_id
  • discover_repo → schema with topics and repos fields
  • search_repos → returns {"repos": [...]} instead of bare array (avoids fastmcp wrap-result)
  • get_trending → returns {"groups": [...]} instead of bare array
  • search_wiki → returns {"results": [...]} instead of bare array
  • get_doc_outline → schema with wiki_id, repo_id, pages fields

Before: {"result": "url: ...\ndescription: ...", "is_error": false}
After: {"url": "...", "description": "...", "language": "...", ...}

Error responses use {"error": "message"} format within the same schema.

Bug Fixes

  • Fix search_repos MCP recursive call error (renamed internal function to _search_repos_api)

v2.2.0

24 May 14:27
2b7b58b

Choose a tag to compare

What's Changed

MCP Tools Return JSON

All structured MCP tools now return JSON instead of plain text, making it easier for AI assistants to parse and use the data:

  • get_repo_info → returns JSON dict with url, name, description, language, topics, stars, status, repo_id, wiki_id
  • discover_repo → returns JSON dict with topics and repos list
  • search_repos → returns JSON list of repo items
  • get_trending → returns JSON list of weekly trending groups
  • get_doc_outline → returns JSON dict with wiki_id, repo_id, and pages list
  • search_wiki → returns JSON list with title, slug, and matches

Text-content tools remain unchanged:

  • read_doc → still returns markdown text
  • read_source_file → still returns source code text
  • ask_ai → still returns AI answer text

Bug Fixes

  • Fix search_repos MCP tool recursive call error

v2.1.1

24 May 12:53
f7c6ad6

Choose a tag to compare

Bug Fixes

  • Fix MCP get_repo_info tool recursive call error - renamed internal function to _get_repo_info to prevent parameter mismatch when called via MCP protocol

v2.0.8

08 Apr 03:53
b81648d

Choose a tag to compare

Full Changelog: v2.0.7...v2.0.8

v2.0.7

04 Apr 09:14
4e189d6

Choose a tag to compare

Release version 2.0.7

Features:

  • Add local config file support (macOS/Linux: ~/.config/zread/zread.toml, Windows: %APPDATA%/zread/zread.toml)

Fixes:

  • Update image links from master to main branch
  • Convert to package structure to properly include locales

v2.0.3

27 Mar 18:30
77fd49d

Choose a tag to compare

Release v2.0.3

v2.0.2

17 Mar 17:43
8666c9d

Choose a tag to compare

Release v2.0.2