LOCAL-FIRST KNOWLEDGE MCP

흩어진 Markdown을
AI가 찾을 수 있는 지식으로.

Agent Docs for Markdown이 만든 Source Graph를 Codex, Claude Code, Gemini CLI에 연결하는 읽기 전용 MCP 서버입니다.

5분 만에 시작하기 소스 코드 보기

✓ MIT License✓ Docker Compose✓ localhost only

knowledge-hub

Source Graph.mps/source-graph.sqlite

ai-monitoring31,274 docs

career-signal732 docs

MCP · read only

WHY THIS PROJECT

Markdown은 그대로 두고,
찾는 방식만 더 똑똑하게

문서 원문과 Source Graph는 읽기 전용입니다. 검색 캐시만 별도 Docker 볼륨에 저장합니다.

⌕

내용 기반 검색

제목과 본문, 관련 heading을 함께 검색하고 바로 읽을 줄 범위를 선택합니다.

◇

여러 워크스페이스

Single, Hub, Named Multi-root 모드로 한 개부터 여러 지식 공간까지 연결합니다.

⌁

링크 영향 분석

문서의 링크와 backlink를 조회해 변경 전 함께 확인해야 할 자료를 찾습니다.

▣

로컬 모니터링

검색, 호출 파라미터, 처리 시간과 오류를 웹 대시보드에서 확인합니다.

8 MCP TOOLS

에이전트가 사용하는 도구

목록 확인부터 검색, 읽기, 연결 관계 조사까지 하나의 안전한 흐름으로 제공합니다.

1. 루트 목록→2. 관련 루트 선택→3. 검색→4. 읽기·링크 확인

list_markdown_roots

워크스페이스 목록

연결된 루트 ID, 설명, 문서 수와 인덱스 상태를 확인합니다.

첫 호출 추천

find_relevant_markdown_roots

질문에 맞는 루트 찾기

질문을 각 루트에 대입해 검색할 워크스페이스 후보와 근거를 반환합니다.

query · limit

search_markdown

선택 루트 검색

하나의 워크스페이스에서 제목과 본문을 검색합니다.

root_id · query · limit

search_all_markdown

전체 동시 검색

여러 루트 결과를 번갈아 배치해 특정 공간의 독점을 막습니다.

query · limit_per_root

read_markdown

문서 구간 읽기

검색한 Markdown 파일에서 필요한 줄 범위만 안전하게 읽습니다.

relative_path · start_line

get_markdown_links

링크와 Backlink

문서가 참조하는 링크와 이 문서를 참조하는 문서를 함께 조회합니다.

root_id · relative_path

get_source_graph_status

인덱스 상태

Source Graph 종류, 문서 수, 캐시 최신성과 오류를 확인합니다.

운영 점검

refresh_markdown_root

캐시 새로고침

현재 Source Graph를 읽어 검색 캐시를 즉시 다시 만듭니다.

원문 수정 없음

GETTING STARTED

설치부터 첫 검색까지

Windows PowerShell 기준입니다. macOS와 Linux에서도 같은 Compose 구성을 사용할 수 있습니다.

01
Agent Docs 확장 설치
VS Code에서 확장을 설치하고 검색할 Markdown 워크스페이스를 엽니다.
```
code --install-extension datanewbie-labs.markdown-agent-docs
```
02
Source Graph 생성
Agent Docs: Initialize Source Graph와 Start Graph를 실행해 아래 파일을 만듭니다.
```
<workspace>/.mps/source-graph.sqlite
```

저장소 클론과 경로 설정

.env의 MARKDOWN_MOUNT_SOURCE를 실제 워크스페이스 경로로 변경합니다.

git clone https://github.com/sungreong/markdown-source-graph-mcp.git
cd markdown-source-graph-mcp
Copy-Item .env.example .env

Docker로 실행

경로를 먼저 검사한 뒤 로컬 전용 MCP 서버를 시작합니다.

python scripts/check_workspace.py "C:/path/to/workspace"
docker compose up -d --build
Invoke-RestMethod http://127.0.0.1:8811/healthz

AI 클라이언트에 등록

codex mcp add markdownSourceGraph --url http://127.0.0.1:8811/mcp
codex mcp list

전체 설치 가이드 에이전트용 프롬프트 보기 →

WORKSPACE MODES

규모에 맞게 연결하세요

컨테이너 실행 후 임의 경로를 열지 않고, 시작할 때 허용한 범위만 검색합니다.

SINGLE

워크스페이스 하나

개인 위키나 하나의 프로젝트를 가장 간단하게 연결합니다.

MARKDOWN_MCP_MODE=single

HUB

공통 폴더 아래 여러 개

허용된 상위 폴더 안에서 Source Graph를 찾아 root_id로 전환합니다.

MARKDOWN_MCP_MODE=hub

MULTI-ROOT

서로 떨어진 여러 경로

각 경로를 명시적으로 읽기 전용 마운트하고 고유 ID를 부여합니다.

docker-compose.multi.yml

LOCAL DASHBOARD

검색과 운영 상태를 한 화면에서

Docker 실행 후 http://127.0.0.1:8811/에서만 확인할 수 있습니다.

ⓘ

이 GitHub Pages 사이트는 제품 안내 페이지입니다. 개인 Markdown 검색과 호출 이력은 외부로 전송되지 않으며, 사용자의 컴퓨터에서 실행한 로컬 대시보드에서만 제공됩니다.

SECURITY BY DEFAULT

내 문서는 내 컴퓨터 안에

서버는 Markdown을 수정하거나 삭제하는 도구를 제공하지 않습니다.

✓ 127.0.0.1에만 포트 공개
✓ 워크스페이스 read-only 마운트
✓ 문서 본문을 감사 로그에 저장하지 않음
✓ 허용한 워크스페이스만 검색

READY TO CONNECT?

Markdown 지식을
에이전트의 도구로 연결하세요.

GitHub에서 시작하기 Agent Docs 설치

흩어진 Markdown을AI가 찾을 수 있는 지식으로.

Markdown은 그대로 두고,찾는 방식만 더 똑똑하게