naite-mcp

naite 지식 나무(vault)를 각자 자신의 Claude Code / Claude Desktop / Codex 에서 읽고 이어붙이게 해주는 MCP 서버다. 도구는 둘뿐이다.

• naite_ask (읽기): 나무가 아는 것에서 답을 찾는다. mode=search|page|neighbors.
• naite_capture (쓰기): 대화에서 뽑은 주장(claims)을 roots/conversations/ 에 스테이징한다.

원칙: 읽기는 넓게, 쓰기는 좁게. 서버는 tree/ 를 직접 쓰지 않고 파생 맵도 재생성하지 않는다. 잎 작성·분류는 풀 하네스를 로드한 naite 세션의 /naite grow 가 큐를 소화하며 한다. 전체 계약은 ../docs/SPEC-mcp-tools.md 를 본다.

전제: naite vault 가 있어야 한다

이 서버는 커넥터이지 vault 자체가 아니다. 이미 나무가 들어 있는 폴더(tree/, roots/, .naite/ 가 있는 저장소)를 가리켜야 한다. 아직 없다면 스타터로 시작해 /naite 스킬로 먼저 키운다 — 빈 폴더는 이 서버가 읽을 게 없다.

vault 경로는 NAITE_ROOT 환경변수 → --root <경로> 인자 → 현재 디렉토리 순으로 찾는다.

각자 에이전트에 붙이기

발행 전 주의: 아직 npm 에 발행하지 않았다. npx -y naite-mcp 는 발행 후 동작한다. 발행 전에는 npm run build 후 로컬 경로(node /절대/경로/mcp/dist/index.js)로 command/args 를 대신 가리킨다.

발행 후에는 전역 설치 없이 npx 로 로컬에서 돈다.

Claude Code

가장 쉬운 길은 마켓플레이스에서 naite 플러그인을 설치하는 것이다. 이 MCP 서버가 함께 등록된다 (vault = Claude Code 를 연 프로젝트 디렉토리).

/plugin marketplace add daehyeonxyz/naite-personal-memory
/plugin install naite

직접 추가하려면:

claude mcp add naite -e NAITE_ROOT=/절대/경로/내-vault -- npx -y naite-mcp

Claude Desktop

claude_desktop_config.json (Windows: %APPDATA%\Claude\, macOS: ~/Library/Application Support/Claude/) 에 추가하고 재시작한다.

{
  "mcpServers": {
    "naite": {
      "command": "npx",
      "args": ["-y", "naite-mcp"],
      "env": { "NAITE_ROOT": "C:/Users/<you>/projects/your-vault" }
    }
  }
}

Codex

~/.codex/config.toml 에 추가한다.

[mcp_servers.naite]
command = "npx"
args = ["-y", "naite-mcp"]
env = { NAITE_ROOT = "C:/Users/<you>/projects/your-vault" }

개발

npm install
npm run build   # tsc -> dist/index.js
npm start       # NAITE_ROOT=/경로 node dist/index.js

배포 (메인테이너)

npm 공개 패키지다. prepublishOnly 가 dist/ 를 먼저 다시 빌드한다.

cd mcp
npm publish     # naite-mcp@<version> 공개 발행 (publishConfig.access = public)

새 빌드를 낼 때는 package.json 의 version 과 src/index.ts 의 McpServer 버전을 함께 올린다.

secrets

naite_capture 는 저장 전 secrets 패턴(API 키, 토큰, private key, 자격증명 대입 등)을 검사한다. 한 건이라도 걸리면 아무것도 쓰지 않고 거절한다. 마스킹 후 저장은 하지 않는다 — 판단은 사람 몫이다.