에스프레소-MCP
Espresso Android 테스트 프레임워크를 위한 MCP 서버로, 테스트 기능을 향상하고 개발 워크플로를 간소화하도록 설계되었습니다.
설치
- 파이썬 3.x
- uv:
pip install uv
지엑스피1
용법
- Claude에 대해: 아래 JSON 구성을
claude_desktop_config.json 파일에 추가합니다.
{
"mcpServers": {
"terminal": {
"command": "uv",
"args": ["pip", "run", "espresso-mcp", "--timeout-ms", "30000"]
}
}
}
사용 가능한 도구
espresso-mcp 프로젝트에서 사용할 수 있는 도구는 다음과 같습니다.
- list_avds : 사용 가능한 모든 Android 가상 장치(AVD)를 나열합니다.
- list_emulators : 실행 중인 모든 Android 에뮬레이터를 나열합니다.
- start_emulator : 이름으로 Android 에뮬레이터를 시작합니다.
- kill_emulator : 특정 Android 에뮬레이터를 종료합니다.
- dump_ui_hierarchy : 연결된 Android 기기의 UI 계층 구조를 덤프합니다.
- open_uri : 연결된 Android 기기에서 URI를 엽니다.
- list_apps : 연결된 Android 기기에 설치된 모든 앱을 나열합니다.
- install_app : 연결된 Android 기기에 APK를 설치합니다.
- start_app : 연결된 Android 기기에서 특정 앱을 시작합니다.
- stop_app : 연결된 Android 기기에서 특정 앱을 중지합니다.
- uninstall_app : 연결된 Android 기기에서 앱을 제거합니다.
- clear_app_data : 연결된 Android 기기의 특정 앱에 대한 앱 데이터를 지웁니다.
- take_screenshot : 연결된 Android 기기의 스크린샷을 찍습니다.
- record_screen : 연결된 Android 기기의 화면을 지정된 기간 동안 녹화합니다.
- press_button : 연결된 Android 기기에서 버튼을 누르는 동작을 시뮬레이션합니다.
- type_text : 연결된 Android 기기에 텍스트를 입력합니다.
- 탭 : 연결된 Android 기기의 특정 좌표에서 탭을 시뮬레이션합니다.
- 스와이프 : 연결된 Android 기기에서 특정 방향으로 스와이프 제스처를 수행합니다.
자원
다음과 같은 리소스를 이용할 수 있습니다.
- config://app : 정적 구성 데이터를 검색합니다.
- greeting://{name} : 개인화된 인사말을 받아보세요.
로컬 설정
- 파이썬 3.x
- uv:
pip install uv
# Install
uv install
# Run Dev Mode
uv run mcp dev server.py
디버깅
# Install MCP Inspector
yarn global add @modelcontextprotocol/inspector
# Test MCP Server
yarn run @modelcontextprotocol/inspector python server.py
테스트
출판
# Build the package
uv build
# Upload to PyPI
uv publish
개발 노트
uv init espresso-mcp
uv add "mcp[cli]"
uv run mcp dev server.py