인간과 AI 에이전트를 위한 제로 빌드 마크다운 서버
mkdnsite는 Mkdnsite에서 제공하는 Markdown 네이티브 웹 서버로, 정적 사이트 빌드 단계 없이 인간 독자와 AI 에이전트 모두에게 문서를 제공합니다. 이 서버는 런타임에 Markdown을 HTML로 렌더링하고, HTTP 콘텐츠 협상을 통해 원시 Markdown을 노출하며, 에이전트 통합을 위한 모델 컨텍스트 프로토콜 엔드포인트를 제공합니다. 이 앱은 GitHub-Flavored Markdown, KaTeX 및 Mermaid 렌더링, 전체 텍스트 검색을 지원하며, 소스 동기화 문서가 필요한 개발자, 기술 작가 및 AI 중심 팀을 대상으로 합니다.
실제로 어떤 작업에 사용할 수 있나요?
이 앱은 인간의 탐색과 기계 소비를 결합한 문서 작업 흐름을 목표로 하며, AI 지원 지역화 및 에이전트 색인 생성을 포함합니다. Claude Desktop, Cursor 및 Zed와 같은 MCP 호스트와 호환되는 기본 모델 컨텍스트 프로토콜 엔드포인트를 제공하며, 명령줄 플래그를 사용하여 공개 또는 비공식 GitHub 리포지토리를 가리킬 수 있어 Git에서 소스를 호스팅하고 즉각적인 사이트 가용성을 기대하는 팀에 실용적입니다.
에이전트가 받는 콘텐츠는 얼마나 신뢰할 수 있나요?
요청에 Accept: text/markdown 헤더가 포함되면 서버는 원본 Markdown 소스를 반환하며, 테이블 및 작업 목록과 같은 GitHub-Flavored Markdown 구조를 보존합니다. 이 전달은 다운스트림 처리를 위한 소스 구조를 보존합니다. 이 앱은 또한 렌더링된 HTML을 위한 KaTeX, Mermaid, 구문 강조 및 Chart.js를 지원하여 시각적 출력을 에이전트가 보는 Markdown 스트림과 분리합니다.
개발자 환경에서 앱을 실행하는 것이 간단한가요?
개발자는 교차 환경 호환성을 제공합니다: 서버는 Bun, Node.js 또는 Deno에서 실행되며, 독립 실행형 실행 파일 또는 Docker 컨테이너로 제공됩니다. 렌더링은 런타임에 React 서버 측 렌더링을 사용하며, 인터페이스에는 TF-IDF 전체 텍스트 검색이 포함되어 있으며 ⌘K 모달과 파일 구조에 의해 구동되는 자동 생성 사이드바 및 목차가 포함되어 있어 기존 리포 기반 문서 파이프라인에 적합합니다.
실시간 소스 우선 문서를 우선시하는 팀을 위한 실용적인 선택
이 앱은 소스 파일과 동일하게 유지되며 에이전트가 즉시 사용할 수 있는 문서가 필요한 개발자 및 기술 문서 팀을 위한 실용적인 옵션입니다. 사전 구축된 아티팩트를 가정하는 워크플로우가 있다면 서버 기반 배포와 적당한 통합 작업이 필요할 것입니다. 직접 Markdown 접근을 대가로 런타임 서버를 수용하는 팀은 이 앱이 에이전트 지향 문서 파이프라인과 일치한다는 것을 알게 될 것입니다.