Skip to main content
Glama
deenesjakoruzh
Avery320

Codex Vault

by Avery320
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Codex Vault

Codex Vault는 Codex 데스크톱 앱의 로컬 플러그인으로, Obsidian 호환 Markdown vault를 읽고, 노트를 검색하며, backlinks와 지식 그래프를 확인하고, 선택한 내용을 채팅 컨텍스트에 추가할 수 있습니다.

[!IMPORTANT] 프로젝트는 아직 초기 개발 단계이며, 현재 personal marketplace를 통해서만 테스트되고 있고 아직 공개 배포되지 않았습니다.

기능

  • Markdown, wikilinks, tags 및 frontmatter를 탐색하고 검색합니다.

  • backlinks, 고아 노트, 끊어진 링크 및 지식 그래프를 표시합니다.

  • 텍스트를 선택하고 메모를 추가하여 Codex composer에 첨부합니다. 자동으로 전송되지 않습니다.

  • 여러 주석을 누적하며, 각 주석은 노트 경로, 텍스트 및 줄 번호를 유지합니다.

  • MCP tools를 통해 안전하게 노트를 읽고 씁니다. 쓰기는 기본적으로 비활성화되어 있습니다.

Related MCP server: vault-master-mcp

사용

설치 후 새 Codex task를 만들고 @Codex Vault를 선택한 다음 'Vault Explorer 열기'를 입력합니다. 플러그인을 업데이트한 후에도 새 task를 사용해야 하며, 기존 task는 MCP tools를 핫 리로드하지 않습니다.

주석 추가:

  1. Markdown reader에서 텍스트를 선택하고 '채팅에 추가'를 누릅니다.

  2. 필요에 따라 메모를 입력하고 다시 '채팅에 추가'를 누릅니다.

  3. composer로 돌아가 질문을 입력하면, 전송할 때 주석과 함께 모델에 전달됩니다.

주석은 채팅 컨텍스트에만 존재하며 Markdown에 다시 쓰이지 않습니다.

기능 경계

  • Codex plugin 및 MCP App이며, Codex App의 fork가 아닙니다.

  • Codex 비공개 UI의 고정 사이드바나 모델 선택 메뉴로 설치할 수 없습니다.

  • 주석은 공개된 updateModelContext()를 사용하며, Codex 비공개 주석 데이터 모델이 아닙니다.

  • 현재 주로 macOS에서 검증되었으며, 다른 플랫폼은 아직 완전히 테스트되지 않았습니다.

개발

요구 사항: Node.js 22+, Yarn Classic 1.x, 그리고 Plugins/MCP Apps를 지원하는 Codex App.

git clone https://github.com/Avery320/codex-vault.git
cd codex-vault
yarn install
yarn build
yarn workspace @foam/mcp test
yarn workspace @foam/graph-view test:unit

personal marketplace가 설정된 환경에서 실행할 수 있습니다:

codex plugin add codex-vault@personal
codex plugin list

./scripts/launch_codex_vault_mcp를 직접 실행하면 stdio server만 시작되고 Codex UI는 표시되지 않습니다. 전체 업데이트 절차는 개발 가이드를 참조하세요.

쓰기

CODEX_VAULT_ALLOW_WRITES=true를 설정하거나 ~/.config/codex-vault/allow-writes의 내용을 true로 설정해야 쓰기 tools가 활성화됩니다.

기존 노트를 수정하려면 먼저 preview_resource_update를 호출한 다음, 반환된 SHA-256으로 update_resource를 호출해야 합니다. 파일이 변경된 경우 conflict가 반환되며 새 내용을 덮어쓰지 않습니다.

문서

Fork 및 라이선스

Codex Vault는 Foam에서 파생되었으며, Markdown, wikilink 및 graph 코어를 계승하고 Codex plugin, MCP App, 다중 vault 관리 및 채팅 주석을 추가했습니다.

이 프로젝트는 MIT License를 사용합니다. 업스트림, Microsoft 파생 소스 및 타사 종속성의 귀속은 NOTICE.md를 참조하세요. Codex Vault는 OpenAI, Obsidian 또는 Foam의 공식 제품이 아닙니다.

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityStale
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • brain-mcp

    delian-research
    A
    license
    A
    quality
    D
    maintenance
    An MCP server for managing Obsidian-style note vaults, providing tools for full-text search, note creation, and backlink tracking. It enables users to navigate, structure, and update their personal knowledge base through natural language.
    9
    MIT

  • vault-master-mcp

    mattbotcode
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that treats Obsidian vaults as knowledge graphs, enabling AI agents to traverse wikilinks, assemble token-budgeted context, and search with backlink awareness.
    3 npm
    1
    MIT

  • obsidian-mcp-server

    DusanMilic
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server that provides natural language access to an Obsidian vault, enabling reading, searching, listing, and creating notes.
    -