Claude Code 대화 내용을 Obsidian 지식 그래프로 변환하는 MCP 플러그인 'recon' 개발

실용적 조언

Claude Code 사용자라면 /plugin install 명령어로 recon을 설치하여 프로젝트 문서화를 자동화할 수 있다.
Obsidian의 그래프 뷰를 활용해 프로젝트의 노드 간 관계를 시각적으로 점검하면 구조적 결함을 파악하기 쉽다.

섹션별 상세

recon은 Claude Code 전용 MCP 서버로 작동하며 대화 맥락을 구조화된 데이터로 변환한다. 사용자가 /recon 명령어를 실행하고 프로젝트를 기술하면, Claude가 이를 파악하여 목표, 페르소나, 모듈, 결정사항 등 10가지 노드 유형으로 분류한다. 결과물은 Obsidian에서 즉시 확인 가능한 [[wikilink]] 형태의 Markdown 파일로 저장되어 시각적인 지식 그래프를 형성한다. 프로젝트의 전체 구조를 한눈에 파악하고 관리할 수 있는 기반이 마련된다.

bash

/plugin install recon@deploysquad-ai/recon

Claude Code에 recon 플러그인을 설치하는 명령어

Obsidian의 그래프 뷰 기능을 통해 시각화된 프로젝트 지식 그래프의 모습이다. — Screenshot'Personal Todo App'이라는 중심 노드를 바탕으로 페르소나, 모듈, 제약 사항 등 다양한 프로젝트 구성 요소들이 연결된 구조를 나타낸다. recon 플러그인이 Claude Code와의 대화에서 추출한 정보들을 어떻게 논리적인 그래프 형태로 변환하여 Obsidian에 저장하는지 실질적인 결과물을 통해 입증한다.

이 도구는 'Context-as-a-Graph' 워크플로우를 통해 LLM의 컨텍스트 유지 문제를 해결한다. 생성된 그래프에서 특정 기능에 대한 컨텍스트를 추출하여 CONTEXT.md 파일을 생성하고, 이를 다음 세션의 입력으로 활용하는 루프를 형성한다. 이를 통해 새로운 세션을 시작할 때마다 과거의 결정사항이나 제약 조건을 다시 기술할 필요 없이 즉시 개발에 착수할 수 있다. 지식의 파편화를 방지하고 모델과의 협업 효율성을 높이는 것이 핵심이다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로 Anthropic이 발표한 오픈 표준 인터페이스이다. AI 모델이 로컬 파일이나 데이터베이스와 같은 외부 데이터 소스에 안전하고 표준화된 방식으로 접근할 수 있도록 설계되었다. 이를 통해 개발자는 다양한 도구를 AI 모델에 쉽게 연결하여 컨텍스트 주입의 효율성을 높일 수 있다.
지식 그래프(Knowledge Graph): — 정보를 개체와 관계의 네트워크 형태로 구조화한 데이터 모델이다. 단순한 텍스트 나열 대신 노드와 엣지를 사용하여 복잡한 프로젝트의 구성 요소 간 상호작용을 시각화하고 관리할 수 있게 한다. LLM이 프로젝트의 전체적인 맥락을 논리적으로 파악하고 유지하는 데 중요한 역할을 수행한다.
옵시디언(Obsidian): — 로컬 Markdown 파일을 기반으로 하는 개인 지식 관리 도구이다. 문서 간의 양방향 링크를 통해 지식의 연결망을 구축할 수 있으며, 이를 시각적인 그래프 뷰로 제공하는 것이 특징이다. 본 아티클에서는 Claude Code의 대화 내용을 영구적으로 저장하고 시각화하는 저장소로 활용된다.

언급된 도구

recon추천링크

Claude Code 대화를 Obsidian 지식 그래프로 변환하는 MCP 서버

Obsidian추천

지식 그래프 시각화 및 Markdown 노트 관리

언급된 리소스

GitHubrecon GitHub Repository