Repolode
제출하기
cosmicstack-labs

cosmicstack-labs/mercury-agent

로컬 메모리와 권한 승인형 도구를 갖춘 셀프 호스팅 AI 에이전트로, CLI·Telegram·Discord·Slack에서 사용할 수 있습니다.

GitHub에서 보기웹사이트
스타
3,881
포크
399
열린 이슈
20
마지막 커밋
어제

어떤 프로젝트인가요?

Mercury Agent는 macOS, Linux, Windows 또는 Termux를 통한 Android 기기에서 실행되는 TypeScript AI 에이전트로, 사용자 기기에서 단일 백그라운드 프로세스로 동작합니다. 로그인 서비스로 설치되어 충돌 후 자동으로 재시작하며, 터미널 UI, Telegram, Discord, Slack, Signal 또는 127.0.0.1에 바인딩된 로컬 웹 대시보드 어디서 접속하든 동일한 에이전트와 메모리를 제공합니다.

일반적인 파일, 셸, 웹 도구에 거버넌스 기능을 더했습니다. 재정의할 수 없는 셸 차단 목록, 폴더별 읽기·쓰기 범위, 승인 요청, SSRF 방어가 적용된 fetch, 로그의 비밀 정보 마스킹을 지원합니다. Second Brain은 유형이 지정되고 중복이 제거된 사실을 로컬 SQLite 데이터베이스에 저장하고, 전문 검색을 지원하며, 답변 전에 관련 정보를 불러옵니다. 또한 일일 토큰 예산으로 각 요청의 사용량을 제한합니다. DeepSeek, OpenAI, Anthropic, Ollama, LM Studio를 비롯해 OpenAI 호환 엔드포인트를 지원하며, 한 제공자가 실패하면 다른 제공자로 대체합니다.

두 가지 모드로 핵심 기능을 확장합니다. Mercury Code는 저장소 안에서 계획을 세우고 작업을 수행하며, 빌드·테스트·타입 검사가 통과한 경우에만 작업 완료를 보고합니다. Mercury Bots는 각자의 페르소나, 권한, 예산을 가진 상시 실행 전문 에이전트로, 일정에 따라 작업하고 완료된 파일을 로컬 폴더에 전달합니다. 약 50개의 도구가 기본 제공되며, 설치 가능한 커뮤니티 스킬과 cron 스타일 스케줄러도 지원합니다.

핵심 기능

  • 01고정된 셸 차단 목록, 폴더별 읽기·쓰기 범위, 세션별 Ask Me 또는 Allow All 모드, SSRF 방어 URL 가져오기를 제공하는 권한 계층.
  • 02Second Brain 메모리: 10가지 유형의 사실을 자동으로 추출해 로컬 SQLite 데이터베이스에 저장하며, 전문 검색, 시간별 정보 통합, `/memory`를 통한 확인을 지원합니다.
  • 03터미널 UI, Telegram, Discord, Slack, Signal, 채팅·Kanban·봇 조종석을 제공하는 localhost 웹 대시보드에서 하나의 런타임에 접속할 수 있습니다.
  • 04Mercury Code는 저장소에서 실시간 계획을 세워 작업하며, 빌드·테스트·타입 검사가 통과한 뒤에만 작업을 완료로 표시합니다.
  • 05Mercury Bots는 지속 실행되는 예약형 전문 에이전트로 동작하며, 단독 또는 작업을 위임하는 플릿으로 실행할 수 있고 봇별 예산과 파일 결과물을 지원합니다.
  • 06DeepSeek, OpenAI, Anthropic, Grok, Ollama, LM Studio 및 모든 OpenAI 호환 엔드포인트 간 제공자 대체를 지원하며, 일일 토큰 예산과 Token Saver 모드도 제공합니다.
  • 07파일, 셸, git, GitHub, 스케줄링, 하위 에이전트, Spotify 등을 다루는 기본 제공 도구 약 50개와 skills.mercuryagent.sh에서 설치할 수 있는 스킬.

활용 사례

  • 노트북을 닫은 뒤에도 메모리를 유지하고 계속 작동하는 개인 비서를 운영하기.
  • 승인 요청과 검증을 거친 뒤에만 성공을 보고하도록 에이전트가 저장소의 코드를 수정하게 하기.
  • 관리자와 멤버에게 역할별 접근 권한을 부여해 공유 Telegram 또는 Discord 채널에서 하나의 에이전트에 접속하기.
  • 반복되는 조사나 보고서 작업을 예약하고 결과 파일을 로컬 폴더나 채팅으로 전달하기.
  • 프롬프트, 키, 대화 데이터를 호스팅 서비스 대신 사용자 디스크에 보관하기.

빠른 시작

  1. 1

    npm으로 설치(Node.js 22 이상)

    npm i -g @cosmicstack/mercury-agent
  2. 2

    Mercury를 실행하고 설정 마법사를 완료하세요

    mercury

사용 전 알아둘 점

  • 설치 스크립트가 웹에서 파이프로 전달되므로, 한 줄 설치 프로그램을 사용하려면 외부 스크립트를 신뢰해야 합니다.
  • 커뮤니티 스킬은 감사되지 않았으므로 설치 전에 검토해야 합니다.
  • 모든 기능을 사용하려면 LLM 제공업체의 API 키 또는 Mercury Cloud 계정이 필요합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱셀프 호스팅 앱CLI·터미널 도구

토픽

#ai-agent#llm#self-hosted#cli#telegram#memory#permissions#scheduler#ai-assistant

자주 묻는 질문

mercury-agent은(는) 무엇인가요?
로컬 메모리와 권한 승인형 도구를 갖춘 셀프 호스팅 AI 에이전트로, CLI·Telegram·Discord·Slack에서 사용할 수 있습니다. Mercury Agent는 macOS, Linux, Windows 또는 Termux를 통한 Android 기기에서 실행되는 TypeScript AI 에이전트로, 사용자 기기에서 단일 백그라운드 프로세스로 동작합니다. 로그인 서비스로 설치되어 충돌 후 자동으로 재시작하며, 터미널 UI, Telegram, Discord, Slack, Signal 또는 127.0.0.1에 바인딩된 로컬 웹 대시보드 어디서 접속하든 동일한 에이전트와 메모리를 제공합니다.
mercury-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mercury-agent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mercury-agent은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mercury-agent의 마지막 커밋은 2026년 11월 6일입니다.
mercury-agent은(는) 어디에 사용할 수 있나요?
노트북을 닫은 뒤에도 메모리를 유지하고 계속 작동하는 개인 비서를 운영하기. 승인 요청과 검증을 거친 뒤에만 성공을 보고하도록 에이전트가 저장소의 코드를 수정하게 하기. 관리자와 멤버에게 역할별 접근 권한을 부여해 공유 Telegram 또는 Discord 채널에서 하나의 에이전트에 접속하기. 반복되는 조사나 보고서 작업을 예약하고 결과 파일을 로컬 폴더나 채팅으로 전달하기. 프롬프트, 키, 대화 데이터를 호스팅 서비스 대신 사용자 디스크에 보관하기.
mercury-agent는 어떻게 설치하나요?
npm으로 설치(Node.js 22 이상): npm i -g @cosmicstack/mercury-agent Mercury를 실행하고 설정 마법사를 완료하세요: mercury
mercury-agent은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cosmicstack-labs/mercury-agent

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트