LangChain OpenWiki 0.2, OKF 지원…MCP 비밀값 격리 수정은 아직 미배포

LangChain 공식 블로그와 OpenWiki GitHub 릴리스에 따르면 코딩 에이전트용 저장소 문서를 자동 생성·유지하는 오픈소스 CLI ‘OpenWiki 0.2.0’이 7월 16일 공개됐다. 이번 버전은 Google Cloud가 제안한 개방형 지식 위키 규격 Open Knowledge Format(OKF)을 적용해, 에이전트가 대규모 코드 문서를 더 구조적으로 찾을 수 있도록 했다.

OpenWiki는 코드 저장소를 분석해 로컬 위키를 만들고, AGENTS.md와 CLAUDE.md에 위키를 참조하라는 안내를 연결한다. 문서가 이미 있으면 OpenWiki가 관리하는 구간만 갱신하며, 저장소별 범위와 우선순위는 별도 지침 파일에 둘 수 있다. GitHub Actions와 GitLab CI, Bitbucket Pipelines를 이용한 정기 업데이트 방식도 제공한다.

0.2부터 생성되거나 갱신되는 위키 문서는 OKF 0.1 형식을 따른다. 각 개념 문서의 YAML 앞부분에는 문서 유형을 나타내는 type이 필수로 들어가고, 제목과 설명, 원본 자원 주소, 태그, 수정 시각 같은 메타데이터를 선택적으로 기록한다. 디렉터리별 index.md는 하위 문서를 요약하고, log.md는 위키 변경 이력을 남긴다.

구조화된 메타데이터의 당장 효과는 문서 형식을 통일하고 변경 범위를 확인하기 쉬워지는 데 있다. LangChain은 앞으로 태그와 범주, 설명을 기준으로 결정론적 검색을 제공할 수 있다고 설명했다. 다만 이런 필터 기반 검색은 향후 도구 방향으로 제시된 것으로, 0.2가 모든 검색 기능을 이미 제공한다는 의미는 아니다.

이번 릴리스에는 모델 공급자 선택지도 추가됐다. 공식 릴리스 노트에는 AWS Bedrock, Google Vertex AI의 Claude, Gemini AI Studio와 Vertex AI, Nebius Token Factory 지원이 포함됐다. 기존의 Gmail과 Notion, X, 웹 검색, Hacker News, 로컬 Git 저장소 연결을 이용해 개인용 지식 위키를 만드는 모드도 유지된다.

배포 뒤에는 자격증명 처리와 관련한 수정이 main 브랜치에 반영됐다. OpenWiki 공식 GitHub의 7월 20일 커밋은 표준입출력 방식 MCP 서버를 실행하는 하위 프로세스가 OpenWiki 프로세스의 전체 환경변수를 상속하던 동작을 바꿨다. 수정 전에는 사용자가 설정한 MCP 서버 명령이 모델 공급자 API 키와 OAuth 갱신 토큰을 포함한 환경변수에 접근할 수 있었다고 커밋 설명은 밝히고 있다.

수정된 코드는 PATH와 임시 디렉터리, 로케일 등 필요한 기본 변수의 허용목록을 만들고, MCP 전송 설정이 명시한 자격증명만 하위 프로세스에 전달한다. 비밀값이 변수 이름이나 값으로 새지 않는지 확인하는 테스트도 함께 추가됐다. 이 변경은 GitHub의 서명 검증된 커밋으로 확인되지만, 별도의 CVE나 공식 보안 권고는 기사 작성 시점 확인되지 않았다.

배포 시점에는 주의가 필요하다. npm 공식 레지스트리에서 최신 버전은 7월 16일 배포된 0.2.0이며, 환경변수 격리 커밋은 그보다 나흘 뒤 main 브랜치에 들어갔다. 기사 작성 시점에는 해당 수정이 포함된 새 정식 릴리스 태그가 없으므로, 설치된 0.2.0에 수정이 반영됐다고 볼 수 없다. 조직에서 MCP 연결을 사용하는 경우 신뢰할 수 있는 서버만 설정하고 후속 릴리스 포함 여부를 확인할 필요가 있다.

OpenWiki 0.2는 에이전트용 저장소 지식을 개방형 형식으로 정리하려는 흐름을 보여준다. 동시에 에이전트가 메일과 문서, 외부 도구에 연결될수록 하위 프로세스에 전달되는 환경변수와 토큰의 범위를 최소화해야 한다는 점도 드러냈다. 실제 비밀값 유출이나 악용 사례는 공개 자료에서 확인되지 않았다.

출처: LangChain 공식 블로그 https://www.langchain.com/blog/openwiki-0-2-adds-okf-support
출처: OpenWiki 0.2.0 공식 릴리스 https://github.com/langchain-ai/openwiki/releases/tag/0.2.0
출처: OpenWiki MCP 환경변수 격리 커밋 https://github.com/langchain-ai/openwiki/commit/37da0a109487f5e595e9e10b85c556c241e9a6c9
출처: npm 공식 레지스트리 https://registry.npmjs.org/openwiki