Work at a Startup MCP Server 🚀

Y Combinator의 채용 공고와 기업을 Work at a Startup을 통해 조회하기 위한 Model Context Protocol (MCP) 서버입니다.

이 MCP 서버는 AI 어시스턴트(Claude Desktop, Cursor, Gemini CLI, Antigravity)에 YC 스타트업 검색, 활성 채용 공고 탐색, 기술 스택 확인, 요구 기술·급여 범위·지분·미국 비자 스폰서십 여부 필터링 기능을 직접 제공합니다.

🛠️ 기능 및 사용 가능한 도구

서버는 4개의 FastMCP 도구를 제공합니다:

1. search_jobs: 고급 필터로 YC 스타트업 채용 공고를 검색합니다.

   • query (str): 검색어 (예: "backend", "AI agent", "Rust").

   • role (Optional[str]): 기능 역할 ("eng", "design", "product", "ops", "sales", "marketing").

   • eng_type (Optional[str]): 엔지니어링 전문 분야 ("be", "fe", "fs", "ml", "mobile").

   • job_type (Optional[str]): 고용 유형 (예: "fulltime", "contract").

   • min_experience (Optional[int]): 최대 요구 경력 연수 (min_experience <= N).

   • max_team_size (Optional[int]): 최대 회사 팀 규모 (company_team_size <= N).

   • batch (Optional[str]): YC 배치 (예: "W24", "S23").

   • remote (bool): 원격 근무 포지션 필터 (True / False).

   • visa (bool): 미국 비자 스폰서십 필터 (True / False).

   • page (int): 페이지 인덱스 (기본값 0).

   • limit (int): 페이지당 회사 수 (기본값 10).

2. get_company_details: YC 기업의 상세 프로필 및 채용 중인 포지션을 가져옵니다.

   • company_id (int): 고유 YC 기업 ID.

   • 반환: YC 배치, 웹사이트, 팀 규모, 위치, 창업자, 기술 스택 설명, 활성 채용 공고 목록.

3. get_job_details: 특정 채용 공고의 전체 세부 정보를 조회합니다.

   • job_id (int): 고유 채용 공고 ID.

   • 반환: 전체 직무 설명(Markdown), 역할 유형, 경력 수준, 급여 범위, 지분 범위, 비자 상태, 요구 기술, 직접 지원 URL.

4. filter_jobs_by_skills: 대상 기술/스킬 목록과 일치하는 활성 채용 공고를 필터링합니다.

   • skills (List[str]): 스킬/기술 목록 (예: ["Python", "PyTorch", "PostgreSQL"]).

   • limit (int): 반환할 최대 일치 채용 공고 수 (기본값 10).

Related MCP server: recruiting-jobs-mcp

💻 빠른 시작 및 설치

옵션 1: uvx 또는 pipx 사용 (권장)

클론하거나 수동으로 설치하지 않고 실행:

uvx workatastartup-mcp

옵션 2: pip 사용

pip install workatastartup-mcp
workatastartup-mcp

옵션 3: 개발 / 소스 설치

git clone https://github.com/MIt9/workatastartup-mcp.git
cd workatastartup-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

⚙️ MCP 클라이언트 구성

Claude Desktop

claude_desktop_config.json에 추가:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "workatastartup": {
      "command": "uvx",
      "args": [
        "workatastartup-mcp"
      ]
    }
  }
}

Cursor / VS Code / Gemini CLI / Antigravity

{
  "mcpServers": {
    "workatastartup": {
      "command": "uvx",
      "args": [
        "workatastartup-mcp"
      ]
    }
  }
}

🧪 테스트 실행

# Run unit & integration tests
.venv/bin/pytest

# Run fast unit tests only (skip live API calls)
.venv/bin/pytest -m "not integration"

📜 라이선스

MIT 라이선스에 따라 배포됩니다.