anonsec-mcp-server

// 보안 커뮤니티를 위해 제작되었습니다 — 후원이 유지보수를 지원합니다

개요

Firefox Relay MCP Server (anonsec-mcp-server)는 Firefox Relay 주소를 통해 포괄적인 익명 이메일 관리 기능을 제공하는 프로덕션 등급의 Model Context Protocol 서버입니다. 개인정보 보호, 보안, 운영 우수성을 핵심 원칙으로 구축된 이 서버는 AI 에이전트와 애플리케이션이 완전한 익명성을 유지하면서 이메일을 보내고, 받고, 처리할 수 있게 해줍니다.

Related MCP server: agent-inbox

핵심 가치 제안

• 개인정보 보호 우선: 모든 이메일 작업은 Firefox Relay 인프라를 통해 발신자 익명성을 유지합니다

• PQC 준비 완료: 저장 데이터를 위한 양자 내성 암호화(PQC) 준비 아키텍처

• 프로덕션 등급: 신뢰성과 보안을 위한 최고 수준의 프로그래밍 관행으로 구축

• MCP 네이티브: 도구와 리소스를 갖춘 완전한 Model Context Protocol 2.0 준수

빠른 시작

사전 요구 사항

• Node.js >= 18.0.0

• npm 또는 yarn

• Firefox Relay 계정 및 API 액세스

설치

# Clone the repository
git clone https://github.com/VRIL-LABS/anonsec-mcp-server.git
cd anonsec-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm run dev

구성

Firefox Relay 자격 증명을 사용하여 .env 파일을 생성하세요:

FIREFOX_RELAY_API_KEY=your_api_key_here
ENCRYPTION_KEY=your_32_byte_hex_key_here
DATABASE_PATH=./data/anonsec.sqlite
PORT=3000

암호화 키는 정확히 32바이트(64자 16진수)여야 합니다. 다음 명령으로 생성하세요:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

기능

이메일 관리

• Firefox Relay 주소에서 새/읽지 않은 이메일 나열

• 복호화를 포함한 전체 이메일 내용 읽기

• 필터링을 통한 모든 이메일 검색

• 모든 릴레이 주소에서 최신 이메일 가져오기

OTP 처리

• 이메일에서 OTP 코드 추출

• OTP 형식 및 신뢰도 검증

• OTP 만료 확인

• 이메일 본문에서 OTP 재추출

이메일 전송

• 릴레이 주소를 통한 익명 이메일 전송

• 일반 텍스트 및 HTML 콘텐츠 지원

• 사용자 정의 헤더 및 메타데이터

• OTP 이메일 시뮬레이션

프로젝트 구조

.
├── src/
│   ├── index.ts          # Server entry point and configuration
│   ├── api/
│   │   └── index.ts      # Firefox Relay API client
│   ├── config/
│   │   └── index.ts      # Configuration management
│   ├── db/
│   │   └── index.ts      # SQLite database service
│   ├── tools/
│   │   ├── all_emails.ts
│   │   ├── latest_email.ts
│   │   ├── latest_email_otp.ts
│   │   ├── new_emails.ts
│   │   ├── read_emails.ts
│   │   └── send_anon_email.ts
│   ├── types/
│   │   └── index.ts      # Type definitions
│   └── utils/
│       ├── crypto.ts     # Encryption utilities
│       └── otp.ts        # OTP extraction utilities
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

도구

서버는 6개의 MCP 도구를 제공합니다:

1. new_emails - 새/읽지 않은 이메일 검색

2. read_emails - 전체 이메일 내용 읽기

3. all_emails - 필터링을 통한 모든 이메일 나열

4. latest_email - 최신 이메일 가져오기

5. latest_email_otp - 최신 이메일에서 OTP 추출

6. send_anon_email - 익명 이메일 전송

리소스

• urn:anonsec:relay/addresses - Firefox Relay 주소 관리

• urn:anonsec:email/collection - 이메일 컬렉션 액세스

• urn:anonsec:otp/emails - OTP 이메일 컬렉션

• urn:anonsec:server/info - 서버 정보

• urn:anonsec:audit/logs - 감사 로그

• urn:anonsec:email/{emailId} - 개별 이메일 액세스

보안 기능

• 저장 데이터를 위한 AES-256-GCM 암호화

• 모든 작업에 대한 변조 불가 감사 로그

• 추적성을 위한 요청 ID 추적

• 민감한 작업에 대한 보안 검증

• 응답에서 OTP 코드 마스킹 (절대 노출되지 않음)

• 감사 로그에서 민감한 데이터 삭제

아키텍처

서버는 깔끔하고 프로덕션 준비가 완료된 아키텍처를 따릅니다:

1. MCP 서버 계층 - 서버 초기화, 도구 등록, 요청 처리

2. 도구 계층 - 개별 도구 구현

3. 핵심 서비스 계층 - 데이터베이스, API 클라이언트, 구성, 타입, 유틸리티

4. 데이터 계층 - PQC 준비 암호화를 갖춘 SQLite 데이터베이스

기여

기여는 환영합니다! 지침은 CONTRIBUTING.md를 참조하세요.

보안

취약점 신고 및 보안 관행은 SECURITY.md를 참조하세요.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다 - 자세한 내용은 LICENSE를 참조하세요.