# suguvisa-mcp

日本の特定技能ビザ申請を自動化するMCPサーバー。申請種別判定、必要書類リスト、期限計算、データ検証に対応。

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add a-kabe-1qio/suguvisa-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list a-kabe-1qio/suguvisa-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get a-kabe-1qio/suguvisa-mcp determine_application_type

# Call a tool
npx -y @smithery/cli@latest tool call a-kabe-1qio/suguvisa-mcp determine_application_type '{}'
```

## Direct MCP Connection

Endpoint: `https://suguvisa-mcp--a-kabe-1qio.run.tools`

## Tools (19)

- `determine_application_type` — 【申請パターン自動判定】現在の在留資格と申請先の在留資格から、正式な申請種別（変更・更新・認定）、使用様式（別記第30号の5等）、標準処理期間、試験免除条件を瞬時に特定。技能実習→特定技能、特定技能1号→2号、転職、更新など全パターンに対…
- `get_required_documents` — 【必要書類リスト生成】申請パターンIDに基づき、入管提出に必要な全書類を一覧化。「2年以内の同一機関申請で省略可」「自社支援なら不要」等の省略条件を自動適用し、実際に準備が必要な書類だけを返す。カテゴリ別（申請人・所属機関・分野別）に整理…
- `validate_application_data` — 【申請データ検証】在留カード番号（12桁英数字）、法人番号（13桁）、日付形式、電話番号等の入力値をリアルタイムにチェック。入管への提出前にデータ不備を検出し、補正指示のリスクを大幅に低減。 / Real-time validation …
- `check_csv_missing_fields` — オンライン申請のCSV生成前に、必須フィールドが揃っているか、およびスキーマに沿って正しく入力されているかをチェックする。 / Pre-check missing/invalid CSV fields.
- `calculate_deadlines` — 【期限自動計算】在留期限・届出発生日から、随時届出の14日ルール期限、更新申請の開始可能日（3ヶ月前）、定期届出期間、通算在留5年上限チェック、認定証明書(COE)の有効期限を自動算出。期限切れリスクを色分け警告。 / Calculate…
- `generate_intake_sheet` — 【入力シート自動生成】申請パターンに応じた情報ヒアリングシートを自動作成。クライアント（受入れ機関）に渡して記入してもらうことで、申請に必要な全データを漏れなく収集。分野別の追加項目にも対応。 / Auto-generates a cus…
- `parse_residence_card` — 【在留カードOCR】在留カードの画像またはOCRテキストから、氏名・国籍・在留資格・在留期限・カード番号等を構造化データに変換。Google Vertex AI Document AIによる高精度OCRと、正規表現フォールバックの二段構え…
- `generate_bulk_xlsm` — 【一括申請Excel生成】出入国在留管理庁の公式一括申請用Excelテンプレート(.xlsm)に申請人データを自動注入。マクロを破壊せずにデータだけを正確に埋め込む独自技術。認定・更新・変更の3種類に対応。 / Injects valid…
- `generate_paper_form` — 【紙申請PDFマッピング】申請パターンに対応する紙申請書（別記第30号の5等）の全フィールドにデータを自動マッピング。記入済み/未記入/必須の状態を可視化し、完成度をパーセントで表示。 / Maps applicant data to o…
- `generate_annual_report_csv` — 【定期届出CSV生成】年1回の特定技能定期届出（受入れ状況・活動状況・支援実施状況）をオンライン一括申請用CSVとして出力。2025年4月改正の新フォーマットに対応。紙提出用データも同時生成。 / Generates annual per…
- `generate_annual_report_offline` — 【定期届出Excel生成】オンライン届出未対応の所属機関向けに、紙提出用の定期報告書をExcel形式で自動出力。JSONデータからセル配置まで全自動。 / Generates offline Excel annual report for…
- `start_autonomous_visa_workflow` — 【自律型ワークフロー開始】AIが対話しながら不足データを収集し、判定→書類リスト→入力シート→検証→書類生成まで自動実行。途中で人間の確認が必要な場合は一時停止し、resume_autonomous_visa_workflowで再開可能。…
- `resume_autonomous_visa_workflow` — 【ワークフロー再開】一時停止中の申請ワークフローに、人間が入力したデータを追加して処理を再開。Human-in-the-Loop（HITL）パターンで安全に申請プロセスを進行。 / Resumes a paused workflow wi…
- `track_submission_outcome` — 入管への申請結果（許可・補正・不許可）をフィードバックとして記録します。このデータにより、申請パターンごとの補正率を統計的に算出し、システムの自己改善に活用します。 / Record immigration submission outc…
- `log_visa_action` — 【操作ログ記録】ビザ申請業務の全アクション（書類確認・提出・結果受領等）を監査ログとしてSupabaseに記録。コンプライアンス対応と業務トレーサビリティを確保。 / Records all visa processing actions…
- `get_visa_audit_logs` — 【監査ログ取得】特定のリソース（申請人・企業等）やイベントに紐づく過去の操作履歴を取得。誰がいつ何をしたかをタイムライン表示し、業務の透明性を担保。 / Retrieves past audit logs for specific res…
- `get_law_updates` — 【法改正情報】特定技能制度に関する最新の法改正・制度変更・運用要領の変更情報を取得。施行日、影響範囲、対応方法を含む。日付・キーワード・ステータスで絞り込み可能。 / Retrieves latest legal updates, reg…
- `search_legal_docs` — 【法務文書検索】Vertex AI Searchによるセマンティック検索で、法務マニュアル・契約書テンプレート・行政届出チェックリスト・SuguVisaマニュアル等を自然言語で横断検索。「特定技能1号 建設 所属機関概要書の書き方」のよう…
- `get_complete_visa_guide` — 【ワンショット完全ガイド】在留資格の変更・更新に必要な情報を一括取得。申請パターン判定 → 必要書類リスト（省略条件適用済み） → 期限計算 → 注意事項を1回のリクエストで全て返す統合ツール。ユーザーが「ビザを変更したい」「更新したい」…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get a-kabe-1qio/suguvisa-mcp <tool-name>
```

## Resources

- `suguvisa://patterns/list` — 特定技能ビザの全申請パターン（変更・更新・認定・転職等）のID・正式名称・処理期間を一覧で取得。determine_application_type を呼ぶ前に、どんなパターンが存在するか確認できます。
- `suguvisa://industries/list` — 特定技能1号の対象16産業分野のコード・試験情報・派遣可否を一覧で取得。分野ごとの技能試験名・実施機関・分野固有書類も含みます。
- `suguvisa://law-updates/latest` — 特定技能制度に関する最新の法改正・制度変更・運用要領改定の一覧。施行済み・施行準備中のステータス付き。get_law_updates ツールのソースデータ。
- `suguvisa://forms/list` — 出入国在留管理庁が公開している特定技能関連の参考様式（申請書類テンプレート）の一覧。様式番号・名称・カテゴリ・記入者・バイリンガル対応状況を含みます。
- `suguvisa://deadlines/rules` — 随時届出14日ルール、更新申請3ヶ月前開始、通算在留5年上限、認定証明書3ヶ月有効期限など、SuguVisa が期限計算に使用する全ルールの定義。calculate_deadlines の判断基準。
- `suguvisa://rules/work-during-application` — 在留資格変更許可申請中の就労可否ルール。「新しい雇用主のもとでは就労不可」「前の雇用主では就労可能」等の重要な注意事項。

## Prompts (7)

- `titp_to_ssw1_workflow` (from_visa, industry_field, applicant_name) — 技能実習から特定技能1号への移行手続きを一通り案内するワークフロー
- `job_change_checklist` (applicant_name, resignation_date) — 特定技能1号スタッフの転職（雇用先変更）時に必要な手続き一式
- `renewal_preparation` (expiry_date, ssw1_start_date) — 特定技能1号の在留期間更新申請の準備ガイド
- `verify_residence_card` (ocr_text) — 在留カードOCR結果の検証と申請データへの反映
- `visual_deadline_calculator` (expiry_date, event_date) — Mermaidを活用した視覚的な期限タイムラインと手続き提案
- `autonomous_visa_wizard` (applicant_name) — ユーザーと対話しながら不足データを集め、書類を一括生成するウィザード
- `submission_feedback` (pattern_id, applicant_name) — 入管から申請結果が返ってきた際に、track_submission_outcome で記録するフィードバックワークフロー