peteretelej / md-server / 21011227154

96%

push

github

md-server MCP Server Improvements (#10)

* mcp: default to markdown output format

Most AI tools use markdown as the default format. Since md-server
converts everything to markdown it makes zero sense for our mcp to
then return json.
- Adds output_format param to opt-in to json if needed

* mcp: expose max_length,timeout,include_frontmatter options

md-server allows clients to customize behavior but the mcp api only
exposes `render_js`. Allow more options

* mcp: add max_token option to control token usage

Website output can be very large, context is expensive. This adds an
option `max_tokens` that LLMs can use to limit the output autonomously.
Token counts are more conventional vs character counts.
- Uses tiktoken to estimate token count

* mcp: support structural truncation - sections,paragraphs

Allow markdown-aware truncation eg first n paragraphs
- truncate_mode option - chars, tokens, sections, paragraphs
- truncate_limit option

* mcp: markdown aware truncation

* mcp: add trunctation metadata

* mcp: rename content as markdown field

* mcp: cleanup parsed titles

* testing: Use parameterized tests

* docs: document mcp usage

* bump up version

212 of 215 branches covered (98.6%)

Branch coverage included in aggregate %.

1408 of 1479 relevant lines covered (95.2%)

0.95 hits per line