
vanooo/upwork-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
vanooo/upwork-mcp는 MCP 서버 후보자로 https://github.com/vanooo/upwork-mcp.에서 수입
개요
vanooo/upwork-mcp는 MCP 서버 후보자로 https://github.com/vanooo/upwork-mcp.에서 수입
개요(AI 번역)
MCP (Model Context Protocol) 서버는 브라우저 자동화를 통해 작업합니다. 작업 검색에 Claude Code를 사용, 제안 관리, 메시지, 및 Upwork에 계약.
특징
-Job Search: 키워드, 예산, 경험 수준 등의 검색 및 필터 작업 -Job Details: 특정 구인정보를 얻으세요 -Profile: 프리랜서 프로필 보기, 밸런스 연결, 통계 -Proposals: 보기, 제출 및 제안 철회 -Messages: Upwork inbox에서 메시지를 읽고 보내 -Contracts: 활성 및 과거 계약 보기, 작업 일기 항목
그것이 작동하는 방법
이 MCP는 **Chrome DevTools Protocol (CDP)**를 사용하여 실제 크롬 브라우저에 연결합니다. 이 접근법:
- Cloudflare의 “자동 테스트 소프트웨어” 탐지 우회
- 역사와 쿠키로 실제 브라우저 프로파일을 사용합니다.
- 벌레 항구 활성화로 달리기 위하여 Chrome를 요구합니다
설치
# 필수품
- 파이썬 3.12+
- uv 패키지 관리자
- Google Chrome 브라우저
소스에서 설치
인증
서버는 CDP (Chrome DevTools Protocol)를 통해 Chrome에 연결합니다.
첫시간 설정
이것은:
- Chrome을 [[T0]로 시작합니다.
- 명세.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Upwork MCP Server
MCP (Model Context Protocol) server for Upwork via browser automation. Enables Claude Code to search jobs, manage proposals, messages, and contracts on Upwork.
Features
- Job Search: Search and filter Upwork jobs by keywords, budget, experience level, etc.
- Job Details: Get comprehensive information about specific job postings
- Profile: View your freelancer profile, connects balance, and stats
- Proposals: View, submit, and withdraw proposals
- Messages: Read and send messages in Upwork inbox
- Contracts: View active and past contracts, work diary entries
How It Works
This MCP uses Chrome DevTools Protocol (CDP) to connect to your real Chrome browser. This approach:
- Bypasses Cloudflare’s “automated test software” detection
- Uses your real browser profile with history and cookies
- Requires Chrome to be running with debug port enabled
Installation
Prerequisites
- Python 3.12+
- uv package manager
- Google Chrome browser
Install from source
cd upwork-mcp
uv sync
Authentication
The server connects to Chrome via CDP (Chrome DevTools Protocol).
First-time setup
# Start login flow - opens Chrome with debug port
uv run upwork-mcp --login
This will:
- Start Chrome with
--remote-debugging-port=9222 - Navigate to Upwork login page
- Wait for you to complete login (click Cloudflare checkbox, enter credentials)
- Save session to
~/.upwork-mcp/chrome-profile/
Check session status
uv run upwork-mcp --check
Clear session
uv run upwork-mcp --logout
Usage
With Claude Code (local development)
Add to your MCP settings (~/.config/claude-code/settings.json or workspace settings):
{
"mcpServers": {
"upwork": {
"command": "uv",
"args": ["--directory", "/path/to/upwork-mcp", "run", "upwork-mcp"]
}
}
}
Available Tools
| Tool | Description |
|---|---|
upwork_search_jobs |
Search for jobs matching criteria |
upwork_get_job_details |
Get detailed job information |
upwork_get_my_profile |
Get your freelancer profile |
upwork_get_connects_balance |
Get current connects balance |
upwork_get_profile_stats |
Get earnings and work history stats |
upwork_get_proposals |
Get your submitted proposals |
upwork_get_proposal_details |
Get details of a specific proposal |
upwork_submit_proposal |
Submit a proposal to a job |
upwork_withdraw_proposal |
Withdraw a submitted proposal |
upwork_get_messages |
Get inbox conversations |
upwork_get_conversation |
Get messages in a conversation |
upwork_send_message |
Send a message |
upwork_get_unread_count |
Get unread message count |
upwork_get_contracts |
Get your contracts |
upwork_get_contract_details |
Get contract details |
upwork_get_work_diary |
Get work diary entries |
설치
uvx upwork-mcp --login설정
{
"mcpServers": {
"upwork": {
"command": "uv",
"args": ["--directory", "/path/to/upwork-mcp", "run", "upwork-mcp"]
}
}
}