Work at a Startup MCP Server 🚀

Сервер Model Context Protocol (MCP) для запроса вакансий и компаний Y Combinator через Work at a Startup.

Этот 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 Batch (например, "W24", "S23").

   • remote (bool): Фильтр по удалённым позициям (True / False).

   • visa (bool): Фильтр по спонсорству визы в США (True / False).

   • page (int): Индекс страницы (по умолчанию 0).

   • limit (int): Количество компаний на странице (по умолчанию 10).

2. get_company_details: Получение подробного профиля YC-компании и открытых вакансий.

   • company_id (int): Уникальный ID компании YC.

   • Возвращает: YC Batch, веб-сайт, размер команды, местоположение, основателей, описание технологического стека и активные открытые вакансии.

3. get_job_details: Получение полных деталей конкретной вакансии.

   • job_id (int): Уникальный ID вакансии.

   • Возвращает: Полное описание вакансии (Markdown), тип роли, уровень опыта, диапазон зарплаты, диапазон доли в акции, статус визы, требуемые навыки и прямую ссылку для подачи заявки.

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.