Agentic Tab Organizer MCP

MCP 호환 AI 에이전트를 Chromium 기반 브라우저의 실시간 탭에 연결하세요. 에이전트는 탭을 나열하고, 선택한 페이지 내용을 읽고, 정리 계획을 미리 보고하며, 유지할 탭을 중복 제거된 하나의 창으로 통합할 수 있습니다.

이 정리 도구에는 AI 모델이 포함되어 있지 않으며 AI API 키도 필요하지 않습니다. MCP 클라이언트는 기존 모델 인증을 사용합니다. Stdio 및 독립형 HTTP 연결은 확장 프로그램이 표시하는 로컬 페어링 토큰을 사용하며, 이 토큰은 사용자 머신을 벗어나지 않습니다.

기능

• 제목, URL, 그룹, 탭 상태를 포함하여 모든 일반 브라우저 창의 탭 나열

• 선택한 HTTP 및 HTTPS 탭에서 제한된 읽기 가능 텍스트 추출

• 정확한 도메인 또는 명시적 탭 ID로 탭 닫기(선택적 하위 도메인 일치 지원)

• 정규화된 정확한 URL의 중복을 제거하면서 기본 복사본 유지

• 명시적으로 허용하지 않는 한 정리 및 임의 닫기 중 고정 탭 보존

• 브라우저를 변경하기 전에 정렬된 카테고리 미리 보고 및 검증

• 표시되는 탭 그룹이 있는 대상 창 하나 또는 왼쪽에서 오른쪽으로의 단일 평면 탭 스트립 생성

• 중복을 닫기 전에 유지할 탭 정렬 및 확인

• 표준 MCP stdio 또는 로컬 Streamable HTTP를 통한 연결

Related MCP server: ChromeWire MCP

요구 사항

• Brave Browser, Google Chrome 또는 기타 호환 Chromium 브라우저

• Node.js 20 이상

• OpenCode, Claude Desktop, Cursor 또는 기타 MCP 클라이언트와 같은 MCP 호환 에이전트

개발 및 실제 브라우저 검증은 주로 Brave로 수행됩니다. Chrome 및 관련 Chromium 브라우저는 동일한 확장 API를 사용하므로 작동할 것으로 예상되지만, 현재 동일한 엔드투엔드 테스트 범위는 적용되지 않습니다.

빌드

npx pnpm@11.24.0 install
npx pnpm@11.24.0 run build

Brave에서 brave://extensions을(를) 열거나 Chrome에서 chrome://extensions을(를) 연 다음 개발자 모드를 활성화하고 압축 해제된 확장 프로그램 로드를 선택한 후 이 저장소의 dist 디렉터리를 선택하세요.

확장 프로그램 팝업을 열고 로컬 페어링 토큰을 복사하세요.

에이전트 연결

Stdio

Stdio가 가장 간단한 옵션입니다. MCP 클라이언트에 dist-node/mcp-stdio.cjs의 절대 경로를 구성하세요:

{
  "mcpServers": {
    "agentic-tabs": {
      "command": "/absolute/path/to/agentic-tab-organizer/dist-node/mcp-stdio.cjs",
      "env": {
        "AGENTIC_TABS_BRIDGE_TOKEN": "TOKEN_FROM_EXTENSION_POPUP"
      }
    }
  }
}

에이전트 프로세스는 localhost 전용 브라우저 브리지를 엽니다. 확장 프로그램이 자동으로 다시 연결됩니다.

Streamable HTTP

지속적인 로컬 서버를 시작하세요:

AGENTIC_TABS_BRIDGE_TOKEN="TOKEN_FROM_EXTENSION_POPUP" npx pnpm@11.24.0 run mcp:http

MCP 클라이언트가 다음을 사용하도록 구성하세요:

http://127.0.0.1:32145/mcp

stdio와 HTTP 모드를 동시에 실행하지 마세요. 둘 다 동일한 로컬 브라우저 브리지 포트를 사용하기 때문입니다.

네이티브 메시징

네이티브 메시징은 macOS와 Linux에서 선택 사항입니다. 설치 관리자는 Google Chrome, Brave, Chromium에 동일한 호스트를 등록합니다:

npx pnpm@11.24.0 run install:host

확장 프로그램을 다시 로드하면 브라우저가 로컬 HTTP MCP 호스트를 자동으로 시작합니다. HTTP MCP 클라이언트를 http://127.0.0.1:32145/mcp에 연결하세요.

에이전트 워크플로

MCP는 다섯 가지 도구를 제공합니다:

예시 요청:

모든 브라우저 탭을 검사하세요. 필요에 따라 모호한 페이지를 요약하고 Work, Reading, Social, Development, Other로 그룹화한 다음 계획을 미리 보세요. 승인 후에는 중복 제거된 하나의 창으로 통합하세요.

amazon.nl의 모든 열린 탭을 닫으세요.

browser_plan_organization은(는) 기본값이 true인 createGroups를 허용합니다. 이 값을 false로 설정하면 카테고리 순서를 왼쪽에서 오른쪽 배치에만 사용합니다. 고정 탭이 먼저 유지되고, 그다음에 지정된 순서대로 각 카테고리가 이어지며, 대상 창에는 표시되는 탭 그룹이 없습니다.

모든 창을 중복 제거된 하나의 창으로 통합하세요. 탭 그룹을 만들지 말고 카테고리를 왼쪽에서 오른쪽으로 배열하세요.

안전 및 개인정보 보호

• 계획 수립은 브라우저를 수정하지 않습니다.

• 계획 수립 후 탭, URL, 창, 고정 상태, 순서 또는 그룹이 변경되면 적용이 중단됩니다.

• 중복 탭은 유지할 탭이 대상 창에서 확인된 후에만 닫힙니다.

• browser_close_tabs는 amazon.nl과 같은 정확한 도메인 또는 browser_list_tabs가 반환한 명시적 ID를 지원합니다. 앞의 www는 정규화되며 하위 도메인은 명시적 동의가 필요합니다.

• 닫기 전에 확장 프로그램은 선택된 모든 탭에 MCP 서버가 관찰한 URL이 그대로 있는지 확인합니다. 그 사이에 탭이 이동했다면 전체 닫기 작업이 중단됩니다.

• 고정 탭은 기본적으로 건너뛰며 skippedTabs에 표시됩니다. 고정 탭을 닫으려면 allowPinned: true가 필요합니다.

• 정리와 임의 닫기 작업은 하나의 변경 잠금을 공유하므로 브라우저를 동시에 변경할 수 없습니다.

• 시크릿 모드 접근은 비활성화되어 있습니다.

• 로컬 WebSocket 브리지는 127.0.0.1에만 바인딩되며 확장 프로그램의 고정 출처만 허용합니다.

• 확장 프로그램과 로컬 MCP 프로세스는 challenge-response HMAC으로 상호 인증하며, 페어링 토큰은 절대 전송되지 않습니다.

• 페이지 콘텐츠는 에이전트가 browser_get_tab_content를 호출할 때만 반환됩니다.

• brave:// 및 chrome://과 같은 보호된 브라우저 페이지는 읽을 수 없지만 나열하고 이동할 수는 있습니다.

• 에이전트에 반환된 콘텐츠는 해당 에이전트에 구성된 모델 공급자에게 전송될 수 있습니다.

개발

npx pnpm@11.24.0 run typecheck
npx pnpm@11.24.0 run test:unit
npx pnpm@11.24.0 run test:integration
npx pnpm@11.24.0 run test:e2e
npx pnpm@11.24.0 run build

엔드투엔드 스위트는 임시 프로필로 Brave를 실행하며 사용자의 일반 브라우저 프로필에는 절대 접근하지 않습니다. Brave는 기본 검증 브라우저이며, Chrome 호환성은 공유 Chromium 확장 API와 브라우저 중립적 통합 경로에서 비롯됩니다.