MCP

agent-config: 여러 AI 도구의 skills와 거버넌스 규칙을 통일, 자체 호스팅 읽기 전용 MCP 엔드포인트 가능

agent-config는 한 벌의 skills와 거버넌스 규칙으로 여러 AI 도구의 설정을 통일하고 읽기 전용 MCP 엔드포인트를 자체 호스팅하려는 개발자에게 가장 잘 맞습니다. 사용 전에 Node ≥ 18이 필요하며, init은 전역 디렉터리에만 기록하고 Worker 쪽은 읽기 전용 거버넌스 콘텐츠만 제공한다는 점에 유의하세요.

Official source · event4u-app/agent-config

Install

npx @event4u/agent-config init

agent-config는 skills, rules, commands, guidelines, personas 한 세트를 npm으로 배포하고 지원되는 AI 도구의 네이티브 설정에 투영하며, Agent Skills 오픈 표준을 따릅니다. 같은 거버넌스 콘텐츠는 자신의 Cloudflare Worker에서 MCP 엔드포인트로 외부에 제공할 수도 있습니다. agent runtime이 아닙니다. agent 루프, LLM 디스패치, 도구 오케스트레이션은 호스트 도구 쪽에 그대로 남습니다. 해결하는 문제는 매우 구체적입니다. 같은 한 세트의 skills와 거버넌스 규칙을 도구마다 따로 설정하지 않아도 되게 하는 것입니다.

누구에게 맞는가

  • 여러 AI 도구를 오가면서 skills와 거버넌스 규칙의 일관성을 유지하고 싶은 개발자와 팀에게 적합합니다. 콘텐츠 레이어는 Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI, Copilot 같은 호스트 도구의 네이티브 설정에 투영될 수 있어, 한 번 관리로 여러 도구에서 함께 씁니다.
  • 자체 호스팅 MCP 엔드포인트가 필요한 개인과 팀에게 적합합니다. 거버넌스 콘텐츠는 자신의 Cloudflare Worker에서 제공되며, Claude Desktop, Claude Code, Cursor, Zed, Continue, 호스팅된 에이전트 등 어떤 MCP 클라이언트든 HTTP로 접근합니다. 클라이언트마다 내용을 따로 유지할 필요가 없습니다.
  • agent runtime으로 쓰기에는 맞지 않습니다. agent 루프를 실행하지 않고 LLM 디스패치와 도구 오케스트레이션도 넘겨받지 않습니다. 작업을 대신 수행하고 모델을 배분해 주는 서비스를 찾는다면, 그 기능은 호스트 도구 안에 있습니다.
  • 로컬 서비스를 설치하자마자 쓸 수 있으리라 기대하는 사람에게는 맞지 않습니다. 내장 local stdio server는 로컬 checkout이 필요하며 설치 즉시 사용이 가능한 형태가 아닙니다.
  • 실행 요건: Node ≥ 18. 그 외 시스템 요구 사항은 근거에 제시되지 않아 미확인입니다.

3분 만에 첫 시도 완료하기

메인 경로는 하나뿐입니다. 공식 canonical 설치 명령 한 번, 그리고 전역 디렉터리 점검 한 번입니다.

  1. 전제: Node ≥ 18이 설치되어 있어야 합니다.
  2. 터미널에서 공식 canonical 명령을 실행합니다: npx @event4u/agent-config init.
  3. 실행 전에 부작용을 분명히 확인합니다. init은 전역 디렉터리에만 기록합니다. ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/ 등이며, 프로젝트 파일은 기록하지 않고 project scope는 메인테이너 전용입니다. 이는 로컬 상태 기록이지 원격 제출이 아닙니다. 되돌리기나 롤백 방법은 근거에 설명되어 있지 않으므로, 영향이 확실치 않으면 이 디렉터리들을 먼저 백업한 뒤 실행하세요.
  4. 성공 신호: 명령이 끝나면 위 전역 디렉터리에 기록된 내용이 나타나고, 지원 도구의 네이티브 설정에서 투영된 skills, rules, commands, guidelines, personas를 볼 수 있습니다. 범위를 먼저 확인하고 싶다면 이 전역 디렉터리 안의 파일을 직접 보면 됩니다.

서버 쪽 방법은 부가 설명에 그칩니다. 자신의 Cloudflare Worker를 배포하면 거버넌스 콘텐츠를 MCP 엔드포인트로 클라이언트에 제공할 수 있습니다. 근거는 이 기능을 확인해 주지만 배포 명령과 설정 조각은 제시되지 않아 구체적인 절차는 미확인입니다. 이는 원격 설정 작업이므로 빠른 시작의 필수 단계로 여기지 마세요. 처음 다룰 때는 읽기 전용 소도구(memory_lookup, list_* 등)를 먼저 호출할 것을 권합니다. 읽기 전용은 쓰기 작업을 수행하지 않는다는 뜻일 뿐이며, 다른 위험이 없다는 뜻도 아니고, 네트워크에 연결하지 않거나 로컬 데이터를 읽지 않는다고 추단할 근거도 아닙니다.

사용 사례

사례 1: Claude Code와 Cursor가 같은 스킬과 규칙을 공유하게 하기. 두 도구의 설정을 따로 관리하면 어긋나기 쉽습니다. Node ≥ 18을 충족하는 컴퓨터에서 npx @event4u/agent-config init을 실행해 콘텐츠 레이어를 전역 디렉터리에 기록하게 합니다. 근거 범위 안에서 기대할 결과: ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/ 등의 디렉터리에 기록이 일어나고, 내용은 Agent Skills 오픈 표준을 따르며, 프로젝트 내부 파일은 영향을 받지 않습니다. 이후 두 도구의 네이티브 설정 어디에서나 같은 한 벌의 skills와 rules를 읽을 수 있습니다. 공식 설명에 따르면 투영 대상은 여기서 예로 든 두 도구가 아니라 지원되는 모든 도구입니다. 적용 시점: 두 도구에서 스킬과 규칙이 따로 진화해 기준이 어긋났고, 한 벌의 콘텐츠를 기준으로 삼고 싶을 때 이 경로를 택합니다. 한계: 콘텐츠 배포만 해결하며, 도구 안에서 스킬을 대신 실행해 주지는 않습니다.

사례 2: 읽기 전용 MCP 거버넌스 엔드포인트 자체 호스팅. 팀은 여러 클라이언트가 HTTP로 통일된 거버넌스 콘텐츠를 읽기를 원하지만 기기마다 설치하고 싶지는 않습니다. 자신의 Cloudflare Worker 위에서 이를 MCP 엔드포인트로 제공합니다. 거버넌스 콘텐츠는 MCP prompts와 resources 형태로 skills, commands, rules, guidelines, contexts를 출력하고 읽기 전용 도구 memory_lookup, chat_history_read, list_*가 딸려 나옵니다. Claude Desktop, Claude Code, Cursor, Zed, Continue, 호스팅된 에이전트 같은 MCP 클라이언트가 HTTP로 접근할 수 있습니다. 관찰 가능한 결과: 클라이언트가 연결되면 prompts와 resources 목록에서 이 거버넌스 콘텐츠를 보고 위 읽기 전용 도구를 호출할 수 있습니다. 함께 예상할 것: Worker는 약 112개의 Python 스크립트(linters, audits, task ci, work-engine hooks)를 실행하지 않습니다. 이 스크립트들은 Quickstart에 따라 로컬에 설치한 뒤 실행합니다. Worker의 배포 절차는 근거에 제시되지 않았으며, 공식이 이 기능을 선언했다는 것까지만 확인할 수 있습니다.

사용 경계

  • 읽기·쓰기 성격: Worker 쪽은 읽기 전용입니다. 거버넌스 콘텐츠는 prompts와 resources로 제공되고, 도구는 memory_lookup, chat_history_read, list_* 같은 읽기 전용 소도구로 한정되며, 쓰기 작업 도구의 존재는 공식적으로 언급되지 않았습니다. init은 로컬 기록이고 범위는 전역 디렉터리뿐이며 프로젝트 저장소는 건드리지 않습니다. 읽기 전용 도구는 쓰기 작업을 하지 않는다는 것만 증명합니다. 네트워크에 연결하는지, 로컬 데이터를 읽는지는 근거에 설명되어 있지 않습니다.
  • 부작용과 확인 지점: init은 ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/ 등에 기록합니다. project scope는 메인테이너 전용이므로 일반 설치는 여러분의 어떤 프로젝트 저장소도 바꾸지 않습니다. 자동 되돌리기나 롤백 방법, 기록되는 파일의 구체적 목록은 근거에 설명되어 있지 않습니다.
  • 공식이 명시한 제한: Worker는 약 112개의 Python 스크립트(linters, audits, task ci, work-engine hooks)를 실행하지 않으며 Quickstart에 따른 로컬 설치가 필요합니다. 내장 local stdio server는 Glama MCP Registry에서 발견용으로만 존재하며 로컬 checkout이 필요합니다(ADR-067 참조).
  • 경로 점검: 도구별 콘텐츠 배포는 init, MCP로 거버넌스 콘텐츠 읽기는 Worker, Python 스크립트 실행은 Quickstart에 따라 로컬 설치 후 실행합니다.
  • 아직 미확인: Worker의 배포 명령과 설정 조각, 클라이언트별 접속 설정, Node ≥ 18 외의 전체 시스템 요구 사항. 이 항목들은 근거에 제시되지 않았으므로, 실행 전에는 공식 저장소를 기준으로 삼으세요.