site-sense은(는) 무엇을 하나요?
AI 코딩 CLI에서 로컬 읽기 전용 MCP 브라우저 확장 프로그램으로 활성 브라우저 탭을 실시간 확인하세요.
개요
site-sense는 MCP (Model Context Protocol)를 사용하여 AI 코딩 에이전트(예: Claude Code, Cursor)가 로컬 브라우저에서 현재 열려 있는 탭을 읽을 수 있도록 하는 브라우저 확장 프로그램입니다.
작동 방식
- 브라우저 확장 프로그램을 설치하고 활성화합니다.
- 확장 프로그램이 로컬 MCP 서버를 시작합니다.
- AI 코딩 도구가 MCP 서버에 연결하여 브라우저 탭 정보를 요청합니다.
- 서버는 현재 탭의 URL, 제목, 페이지 콘텐츠 등을 읽기 전용으로 반환합니다.
지원 플랫폼
- Claude Code (CLI 기반)
- Cursor (IDE 내장 AI)
- 기타 MCP 호환 AI 코딩 도구
설치 방법
1. 브라우저 확장 프로그램 설치
- Chrome/Edge: Chrome 웹 스토어에서 설치
- Firefox: Firefox 부가 기능 스토어에서 설치
- Safari: 수동 설치 필요 (아래 참조)
2. MCP 서버 설정
확장 프로그램이 설치되면 자동으로 로컬 MCP 서버가 시작됩니다. 기본 포트는 9090입니다.
# MCP 서버 상태 확인
echo '{"jsonrpc": "2.0", "id": 1, "method": "list_tabs"}' | nc localhost 9090
3. AI 코딩 도구 연결
Claude Code
~/.claude/settings.json에 다음을 추가하세요:
{
"mcpServers": {
"site-sense": {
"url": "http://localhost:9090/mcp"
}
}
}
Cursor
Cursor 설정에서 MCP 서버를 추가하세요:
- 설정 → MCP 서버
- 새 서버 추가:
http://localhost:9090/mcp - 저장
사용 예시
> 현재 브라우저 탭에서 무엇을 보고 있는지 알려줘.
현재 탭:
1. GitHub - Pull Request #42 (https://github.com/example/repo/pull/42)
2. 공식 문서 - MCP 소개 (https://modelcontextprotocol.io/introduction)
> 첫 번째 탭의 요약을 만들어줘.
Pull Request #42: 새로운 로그인 시스템 구현 중...
보안 및 개인정보
- 읽기 전용: 확장 프로그램은 탭 정보 읽기만 가능하며, 수정이나 실행은 불가능합니다.
- 로컬 전용: 모든 데이터는 로컬에서 처리되며 외부 서버로 전송되지 않습니다.
- 권한: 사용자가 명시적으로 활성화한 경우에만 작동합니다.
문제 해결
| 문제 | 해결 방법 |
|---|---|
| MCP 서버가 실행되지 않음 | 브라우저 확장 프로그램이 활성화되어 있는지 확인하세요. |
| 탭 정보를 가져올 수 없음 | 브라우저 권한 설정에서 '모든 사이트 데이터 읽기'를 허용하세요. |
| AI 도구 연결 실패 | 올바른 URL(http://localhost:9090/mcp)을 사용하고 있는지 확인하세요. |
라이선스
MIT
기여
버그 신청 및 기능 제안은 GitHub 저장소에서 이슈를 열어주세요.