VU

vanooo/upwork-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

72 stars 23 forks 품질 58 트렌드 14NOASSERTION

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에 연결합니다.

첫시간 설정

이것은:

  1. Chrome을 [[T0]로 시작합니다.
  2. 명세.

이 페이지는 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:

  1. Start Chrome with --remote-debugging-port=9222
  2. Navigate to Upwork login page
  3. Wait for you to complete login (click Cloudflare checkbox, enter credentials)
  4. 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
GitHub에서 전체 README 보기

설치

uvx upwork-mcp --login
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "upwork": { "command": "uv", "args": ["--directory", "/path/to/upwork-mcp", "run", "upwork-mcp"] } } }