v0.8.7
Pre-release
Summary
This release introduces significant changes in how we retrieve and process documentation pages. This is the first step in an effort to improve the relevance of the results and optimize token output size.
Results should be returned slightly faster due to fewer operations being done under the hood. The MCP Server now consumes Markdown versions of the docs rather than retrieving the HTML version and then converting it to Markdown locally. We've also made changes to caching.
For caching, we've moved the cache from the user home directory to the temp directory of each OS. Additionally, we've changed how content is cached to prioritize data freshness while still avoiding redundant requests. For each documentation page requested by the MCP, we first query the docs to retrieve the eTag of a page and compare it with the eTag of the cached version. If they match, we return the cached page; otherwise we load the remote one.
The output and quality of results should be comparable to previous versions. If you spot any regression or issue, please don't hesitate to open an issue.
Over the coming weeks we'll work on improving the search feature and experiment with returning only portions of the page that are relevant to the query, rather than the entire page. Stay tuned for more details!
Changes
- feat: add Java runtime versioning support (#91) by @dreamorosi
- feat: refactor search docs tool (#83) by @dreamorosi
- fix(build): remove esbuild and use tsc for the compilation (#74) by @walmsles
- fix: handle .NET & Java url schemes (#82) by @dreamorosi
- feat: consume md docs directly (#78) by @dreamorosi
- test: add e2e tests (#73) by @dreamorosi
- chore: update release workflow (#70) by @dreamorosi
- ci: release workflows (#63) by @dreamorosi
- chore: add maintainers handbook (#62) by @dreamorosi
- ci: Harden GitHub Actions (#58) by @step-security-bot
- chore: enable CodeQL & add OSSF badge (#56) by @dreamorosi
- chore: add experimental banner (#44) by @hjgraca
- chore: standardize repo (#49) by @dreamorosi
- fix(worfklows): fix concurrency of version bump and release workflows… (#41) by @walmsles
- fix(action): resolve action lint issue in version bump (#40) by @walmsles
- fix(actions): ensure dry-run actions have NPM_TOKEN (#39) by @walmsles
- Fix docs (#38) by @walmsles
- fix: markdown converter, replace regex with cheerio for extracting ma… (#37) by @walmsles
- feat(fetchDoc): refactor markdown conversion process and create conve… (#36) by @walmsles
- chore(workflow): release workflow manual (#35) by @walmsles
- Feat enable version (#34) by @walmsles
- Github-actions set permissions (#33) by @walmsles
- chore(deps): update pnpm-lock.yaml (#32) by @walmsles
- chore(cicd): setup github actions and release workflow (#31) by @walmsles
- Feat logging (#29) by @walmsles
- bug(runtime): Ensure runtime and other parameters is sanitised (#28) by @walmsles
- Feat limit search (#27) by @walmsles
- fix(fetchDoc): Ensure markdown regenerated on cache miss (#26) by @walmsles
- chore(lint): fix IDE lint issues on mock types (#21) by @walmsles
- Version bump ready for next release (#20) by @walmsles
- feat(fecthDoc): Cache markdown files (#19) by @walmsles
- release(ver): version bump for release (#15) by @walmsles
- feat(searchIndex): load search index from runtime docs online (#14) by @walmsles
- feat(fetchDoc): (#13) by @walmsles
- chore(license): update and relocate the LICENSE file (#8) by @walmsles
- add MCP server badge (#7) by @punkpeye
- Feat html markdown (#6) by @walmsles
🔧 Maintenance
- chore(deps): bump zod from 3.25.61 to 3.25.63 (#88) by @dependabot[bot]
- chore(deps): bump @types/node from 24.0.0 to 24.0.1 (#89) by @dependabot[bot]
- chore(deps): bump @types/cacache from 17.0.2 to 19.0.0 (#85) by @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.19 to 3.29.0 (#87) by @dependabot[bot]
- chore(deps): bump @types/node from 22.15.30 to 24.0.0 (#80) by @dependabot[bot]
- chore(deps-dev): bump @modelcontextprotocol/inspector from 0.13.0 to 0.14.0 (#65) by @dependabot[bot]
- chore(deps): bump zod from 3.25.55 to 3.25.56 (#77) by @dependabot[bot]
- chore(deps-dev): bump the vitest group across 1 directory with 2 updates (#51) by @dependabot[bot]
- chore(deps): bump zod from 3.25.49 to 3.25.51 (#52) by @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.18 to 3.28.19 (#50) by @dependabot[bot]
This release was made possible by the following contributors:
@actions-user, @dependabot[bot], @dreamorosi, @github-actions[bot], @hjgraca, @punkpeye, @semantic-release-bot, @step-security-bot, @walmsles, dependabot[bot] and github-actions[bot]
