Next Role Mcp Proxy

NextRole MCP プロキシ

NextRole のプロフェッショナル向け CV およびカバーレターのカスタマイズサービスにアクセスするための、Model Context Protocol（MCP）プロキシサーバーです。このプロキシを使うと、MCP 対応クライアントから NextRole のホスト型サービスを利用できます。

特長

• プロフェッショナル向け CV のカスタマイズ：特定の求人応募に合わせて CV をカスタマイズできます
• カバーレターの作成：求人要件に合ったカバーレターを作成できます
• 複数のサービスレベル：エントリー、ミッド、シニアの各レベルに対応したプロフェッショナルサービス
• クレジット管理：サービスクレジットの残数確認と管理
• 国際対応：世界中のユーザーが利用できます

インストール

ソースから

リポジトリをクローンし、インストールスクリプトを実行します。依存関係のインストールとプロジェクトのビルドが行われ、MCP クライアント設定用の JSON が表示されます。

git clone https://github.com/bats64mgutsi/nextrole-mcp-proxy.git
cd nextrole-mcp-proxy

Linux / macOS：

bash install.sh

Windows（PowerShell）：

.\install.ps1

スクリプトの最後に、ローカルのインストール先への正しいパスが設定された MCP クライアント設定用の JSON が表示されます。これを MCP クライアントの設定ファイルにコピーしてください。

npx を使用（ローカルインストール不要）

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "nextrole": {
      "command": "npx",
      "args": ["nextrole-mcp-proxy"]
    }
  }
}

使用方法

利用可能なツール

1. get_pricing

利用可能なキャリアレベルと、それぞれの商品 ID を取得します。注文を行う前にこのツールを呼び出し、正しい productId を取得する必要があります。

使用方法：

What are your different CV tailoring packages?

応答：

[
  {
    "CountryCode": "ZA", 
    "ServiceTier": "Entry Level",
    "ProductId": 1
  },
  {
    "CountryCode": "ZA",
    "ServiceTier": "Mid Level", 
    "ProductId": 2
  },
  {
    "CountryCode": "ZA",
    "ServiceTier": "Senior Level",
    "ProductId": 3
  }
]

2. get_credits

顧客の残りクレジット数を確認します。注文ごとにクレジットを 1 つ消費します。

パラメーター：

• phoneNumber（必須）：国番号を含む顧客の電話番号（例：+27831234567）

使用方法：

How many credits do I have left? My phone number is +27831234567

応答：

{
  "credits": 5
}

3. place_order

カスタマイズされた CV とカバーレターを注文します。注文の完了には通常約 15 分かかります。注文が確定したときと書類の準備ができたときに、顧客へ SMS 通知が送信されます。注文ごとにクレジットを 1 つ消費します。

パラメーター：

• customerPhone（必須）：国番号を含む顧客の電話番号。「+」で始まる必要があります（例：+27831234567）
• customerFirstName（必須）：顧客の名
• customerLastName（必須）：顧客の姓
• cvMarkdown（必須）：Markdown 形式の顧客の現在の CV
• productId（必須）：顧客のキャリアレベルに対応する商品 ID（先に get_pricing を呼び出してください）
• jobDescription（必須）：顧客が応募する求人の詳細な説明

使用方法：

I need to tailor my CV for a Junior Software Developer position. My phone number is +27831234567, my name is John Smith, and here's my current CV in markdown:

# John Smith
## Experience
- Junior Developer at TechCorp (2023-present)

The job description is: We are seeking a Junior Software Developer to join our team with React and Node.js experience.

応答：

{
  "orderKey": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "message": "Order placed successfully. SMS notifications sent."
}

使用例

エントリーレベルのプロフェッショナル

新卒者やキャリア初期のプロフェッショナルに最適です。

I'm Sarah Johnson (+44207123456) and need my CV tailored for this graduate software engineer role: Graduate Software Engineer requiring Python programming and problem-solving skills. 

My current CV:
# Sarah Johnson
## Education
- Computer Science Degree, University of London (2024)
## Projects  
- Built a web application using Python and Flask

キャリアチェンジ

業界を移るプロフェッショナル向けです。

I'm transitioning from finance to tech and need my CV (+27831112233, Jane Doe) tailored for this software developer role: Full Stack Developer position requiring JavaScript, React, and database skills.

Current CV:
# Jane Doe
## Background
- Financial Analyst at Bank Corp
- Recently completed coding bootcamp

シニアエグゼクティブ

C レベルおよびシニア管理職向けです。

I'm Michael Chen from the US (+1555123456) and need my executive CV customized for this CTO role: Chief Technology Officer requiring strategic leadership and team management skills.

My current CV:
# Michael Chen
## Executive Summary
Senior Technology Leader with 15+ years experience
## Experience
- VP Engineering at Tech Startup (2020-2024)

サービスレベル

• エントリーレベル（商品 ID：1）：新卒者やキャリア初期のプロフェッショナル向け
• ミッドレベル（商品 ID：2）：経験年数 3～10 年のプロフェッショナル向け
• シニアレベル（商品 ID：3）：シニアプロフェッショナル、マネージャー、エグゼクティブ向け

プライバシーと利用規約

このサービスを利用すると、NextRole の以下の規約に同意したことになります。

• プライバシーポリシー
• 利用規約

開発

ビルド

npm run build

開発モードでの実行

npm run dev

ローカルでのテスト

npm start

アーキテクチャ

これは、MCP リクエストを NextRole のホスト型サービス https://api.nextrole.co.za/firstroleprod-mcp/mcp に転送する軽量なプロキシです。このプロキシは次の処理を行います。

• MCP プロトコルのリクエストを変換します
• ホスト型サービスに転送します
• 形式を整えた応答を MCP クライアントに返します
• エラーや接続の問題に対処します

要件

• Node.js 18.0.0 以降
• NextRole のホスト型サービスに接続するためのインターネット接続

ライセンス

MIT License — 詳細については LICENSE ファイルを参照してください。

サポート

このプロキシに関する技術的な問題については、GitHub で issue を作成してください。 サービスに関するご質問は、NextRole の公式チャネルからサポートにお問い合わせください。