peteretelej/md-server

md-server - HTTP API Server and MCP Server for converting everything to markdown

What's novel

md-server - HTTP API Server and MCP Server for converting everything to markdown

Code Analysis

5 files read · 2 rounds

A FastAPI-based service that accepts URLs, files, or text and converts them to Markdown using an external engine, returning either raw Markdown or JSON metadata.

Strengths

Excellent separation of concerns with a dedicated controller layer handling request parsing, validation, and routing. The codebase demonstrates strong attention to security (SSRF protection) and backward compatibility. Naming conventions are clear and consistent throughout the project.

Weaknesses

The core conversion logic is entirely delegated to an external library (`document_converter`), meaning the substance of the application lies outside this repository. Test coverage appears moderate, focusing primarily on API layer behavior rather than deep integration or edge cases in the underlying engine.

Score Breakdown

Innovation

4 (25%)

Craft

84 (35%)

Traction

8 (15%)

Scope

84 (25%)

Signal breakdown

Innovation

Not Fork+1

Code Novelty+1

Concept Novelty+1

Craft

Ci+5

Tests+8

Polish+2

Releases+4

Has License+5

Code Quality+23

Readme Quality+15

Recent Activity+7

Structure Quality+5

Commit Consistency+5

Has Dependency Mgmt+5

Traction

Forks+0

Stars+6

Hn Points+0

Watchers+0

Early Traction+0

Devto Reactions+0

Community Contribs+2

Scope

Commits+8

Languages+8

Subsystems+13

Bloat Penalty+0

Completeness+7

Contributors+6

Authored Files+15

Readme Code Match+3

Architecture Depth+7

Implementation Depth+8

Evidence

Commits

101

Contributors

Files

104

Active weeks

TestsCI/CDREADMELicenseContributing

Repository

Language

Python

Stars

Forks

License

MIT