<h1>
Alfred 5 Workflows MCP
</h1>
GitHub stars License: MIT Python 3.10+ Release
Alfred 5 Workflows MCP banner
macOS용 Alfred 5 앱(alfredapp.com)의 Powerpack을 사용하여 Claude, Cursor 및 기타 MCP 클라이언트에서 워크플로우를 제어합니다.
Alfred API 플랫폼(lumberjack-so/alfred-mcp)과는 관련이 없습니다.
Alfred 5 Workflows MCP는 AI 비서와 macOS Alfred 5를 직접 연결합니다. 이를 통해 AI 모델은 자연어를 사용하여 Alfred 워크플로우를 검색하고, 생성하며, 수정하고, 실행하고, 패키징할 수 있습니다.
Features
- 워크플로우 목록 및 검색 (List & Search Workflows): 이름, 번들 ID 또는 키워드를 통해 설치된 Alfred 워크플로우를 즉시 스캔합니다.
- 심층 검사 (Deep Inspection): 워크플로우 구성, 노드 객체, 스크립트 코드, plist 데이터 및 포함된 파일을 읽습니다.
- 워크플로우 생성 (Create Workflows): UUID, 노드 및 캔버스 배치를 갖춘 템플릿(
keyword_script, script_filter, hotkey_trigger, empty)에서 새로운 Alfred 5 워크플로우를 생성합니다.
- 편집 및 업데이트 (Edit & Update): 메타데이터(이름, 설명, 번들 ID, README)를 수정하고 스크립트 내용 또는 키워드를 실시간으로 업데이트합니다.
- 파일 관리 (File Management): 워크플로우 폴더 내에서 임베디드 스크립트, Python 모듈, 셸 파일 또는 구성 에셋을 직접 생성하거나 업데이트합니다.
- 트리거 액션 (Trigger Actions): macOS AppleScript를 통해 Alfred 외부 트리거(External Triggers)를 프로그래밍 방식으로 실행합니다.
- 내보내기 및 패키징 (Export & Package): 배포를 위해 워크플로우를 표준
.alfredworkflow 파일로 패키징합니다.
- 안전 삭제 (Safe Deletion):
send2trash를 사용하여 워크플로우를 macOS 휴지통으로 이동시켜 안전하게 삭제합니다.
Prerequisites
- macOS 12.0 이상.
- 활성화된 Powerpack 라이선스를 가진 Alfred 5.
- Python 3.10 이상.
Quick Setup & Onboarding
선호하는 설치 방법을 선택하세요:
Option A: 원클릭 자동 설정 (권장)
환경을 생성하고 종속성을 설치하며, alfred-mcp를 Claude Desktop, Cursor, 및 Antigravity IDE에 자동으로 등록하려면 자동화된 설치 스크립트를 실행하세요:
git clone https://github.com/saihgupr/alfred-mcp.git
cd alfred-mcp
./install.sh
옵션 B: 제로 설치 방식 실행 (uvx / pipx)
만약 uv를 사용한다면, 수동으로 클론하거나 가상 환경을 관리할 필요 없이 alfred-mcp를 직접 실행할 수 있습니다. 다음 항목을 MCP 클라이언트 설정(예: claude_desktop_config.json)에 추가하세요:
{
"mcpServers": {
"alfred": {
...
옵션 C: 수동 설정
- 클론 및 환경 설정:
git clone https://github.com/saihgupr/alfred-mcp.git
cd alfred-mcp
python3 -m venv .venv
...
2. 자동 설치 프로그램 명령어 실행:
```bash
python server.py --install
또는 다음 블록을 ~/Library/Application Support/Claude/claude_desktop_config.json에 수동으로 추가하세요:
{
"mcpServers": {
"alfred": {
...
사용 가능한 MCP 도구
| 도구 이름 | 설명 |
|---|
alfred_list_workflows | 검색 쿼리 필터링(이름, 번들 ID, 키워드 일치)을 포함하여 설치된 모든 Alfred 워크플로우 목록 조회. |
| ... | |
문제 해결 및 디버깅
alfred-mcp 사용 중 문제가 발생하면:
1. 로그 위치
- Claude Desktop 로그: 실행 오류는
~/Library/Logs/Claude/mcp.log와 ~/Library/Logs/Claude/mcp-server-alfred.log를 확인하세요.
- Antigravity IDE 로그:
~/.gemini/antigravity-ide/mcp_config.json 및 에이전트 세션 로그를 검사하세요.
- Cursor 로그: Cursor의
Output 패널을 열고 MCP Server Log를 선택하세요.
2. macOS 자동화 권한
alfred_run_trigger는 Alfred 5와 통신하기 위해 AppleScript (osascript)를 사용합니다.- MCP 클라이언트(Antigravity IDE / Claude Desktop / Cursor / Terminal)가 다음 경로에서 권한을 가지고 있는지 확인하십시오:
시스템 설정 > 개인 정보 보호 및 보안 > 자동화 > [사용자 클라이언트] > Alfred 5
3. Alfred 환경설정 동기화 폴더
alfred-mcp는 기본 위치(~/Library/Application Support/Alfred/Alfred.alfredpreferences/workflows, Dropbox, iCloud Sync 경로)를 자동으로 스캔합니다.- 워크플로우가 사용자 지정 폴더에 저장된 경우, Alfred 5 환경설정 plist (
com.runningwithcrayons.Alfred-Preferences-3.plist)이 현재 동기화 폴더를 가리키는지 확인하십시오.
4. 대화형 MCP Inspector
MCP Inspector 도구를 사용하여 서버 도구를 로컬에서 테스트합니다:
npx @modelcontextprotocol/inspector .venv/bin/python server.py
기여 (Contributing)
기여를 환영합니다! 모든 Pull Request는 develop 브랜치로 제출해 주십시오.
- 저장소 포크(Fork)하기
- 기능 브랜치 생성 (
git checkout -b feature/awesome-feature)
- 변경 사항 커밋 및 자신의 포크에 푸시
- develop으로 Pull Request 열기
지원 및 피드백 (Support & Feedback)
문제가 발생하거나, 버그를 발견했거나, 기능 요청이 있는 경우 GitHub에서 이슈를 열어주십시오.
Alfred 5 Workflows MCP는 오픈 소스이며 무료입니다. 유용하다고 생각되시면 별점 ⭐을 주시거나 개발 지원을 위해 기부를 고려해 주세요!
ko-fi
