@conxt/mcp

로컬 우선(Local-first) 방식의 관리型 AI 메모리용 MCP 서버. 에이전트가 메모리를 제안하고, 사용자가 승인하며, 승인된 메모리만 회상됩니다. 계정 없이 독립 실행되며, 팀 메모리를 위해 선택적으로 Conxt 클라우드에 동기화할 수 있습니다.

오픈 Governed Memory Record 포맷을 구현합니다.

빠른 시작

설치나 가입 없이 IDE에 연결하기만 하면 됩니다:

Cursor (~/.cursor/mcp.json)

{ "mcpServers": { "conxt": { "command": "npx", "args": ["-y", "@conxt/mcp"] } } }

Claude Code

claude mcp add conxt -- npx -y @conxt/mcp

Claude Desktop → 설정 → 개발자 → 구성 편집: Cursor와 동일한 블록을 사용합니다.

이것으로 끝입니다. 메모리는 사용자 컴퓨터의 ~/.conxt/memory.json에 저장됩니다.

Related MCP server: Centralaizer

도구

관리型으로 만드는 핵심 규칙: 에이전트는 제안할 수 있지만, 승인은 사람만 할 수 있습니다 — 그리고 recall은 승인되지 않은 것은 절대 반환하지 않습니다.

터미널에서의 사람 승인

npx @conxt/mcp pending          # what's waiting
npx @conxt/mcp approve <id>     # approve it
npx @conxt/mcp reject <id>
npx @conxt/mcp list
npx @conxt/mcp path             # where the store lives

개인 사용 시 마찰을 없애고 싶다면 CONXT_AUTO_APPROVE=1을 설정하면 remember한 모든 항목이 즉시 승인됩니다.

클라우드 모드 (선택 사항)

로컬이 항상 진실의 원천(source of truth)입니다. 두 환경 변수를 모두 설정하면 승인된 레코드가 팀 차원의 공유되고 관리되는 메모리를 위해 Conxt 워크스페이스로도 푸시됩니다:

CONXT_API_KEY=...      CONXT_API_URL=https://...

동기화 실패는 로컬 메모리에 절대 영향을 미치지 않습니다.

구성

개발

npm install && npm run build && node dist/index.js

라이선스

MIT.

배포

CI (.github/workflows/ci.yml)는 모든 푸시 시 빌드와 거버넌스 스모크 테스트를 실행합니다. npm에 릴리스하려면:

1. npmjs.com에서 @conxt 스코프를 소유하고 있는지 확인 — 또는 package.json에서 패키지 이름을 비스코프 conxt-mcp로 변경하세요.

2. NPM_TOKEN (Automation 토큰)을 저장소 시크릿으로 추가하세요 (Settings → Secrets and variables → Actions).

3. 릴리스를 생성하세요:

   npm version patch      # or minor / major — creates a v* tag
   git push --follow-tags

   publish 워크플로우는 빌드, 스모크 테스트, npm publish --access public을 실행합니다.

또는 수동으로 배포:

npm install && npm run build && npm login && npm publish --access public