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): 1 ページあたりの企業数（デフォルト 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 License の下で配布されています。