Pqs Prompt Quality Score

PQS MCP サーバー

AI モデルに届く前に、プロンプトの品質を評価します。PQS の MCP サーバーです。

モデルに渡す前に、LLM プロンプトのスコアを算出し、最適化します。PEEM、RAGAS、MT-Bench、G-Eval、ROUGE を基盤としています。

インストール

Claude Desktop（stdio）

設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "pqs": {
      "command": "npx",
      "args": ["-y", "pqs-mcp-server"]
    }
  }
}

リモート（HTTP）

MCP クライアントがストリーミング可能な HTTP トランスポートに対応している場合に使用します（ローカルでの npm インストールは不要です）：

{
  "mcpServers": {
    "pqs": {
      "url": "https://promptqualityscore.com/api/mcp"
    }
  }
}

Smithery

smithery mcp add onchaintel/pqs

ツール

score_prompt（無料、API キー不要）

0～80 のスコア、A～F の評価、8 つの次元（明瞭さ、具体性、コンテキスト、制約、出力形式、役割の定義、例、CoT 構造）の詳細な内訳、および最も弱い次元を返します。IP ごとのレート制限は、1 分あたり 5 回、1 日あたり 10 回、1 か月あたり 100 回です。

低スコア帯と中スコア帯では、メッセージ、optimize_prompt を示す next_tool ポインター、および利用する LLM がユーザーに言い換えて伝えられる登録 URL を含む、構造化された suggestion フィールドも返されます。

出力例（低スコア帯、提案付き）：

{
  "pqs_version": "2.0",
  "prompt": "analyze this wallet",
  "score": 9,
  "out_of": 80,
  "grade": "F",
  "dimensions": {
    "clarity": 2,
    "specificity": 1,
    "context": 1,
    "constraints": 1,
    "output_format": 1,
    "role_definition": 1,
    "examples": 1,
    "cot_structure": 1
  },
  "weakest_dimension": "specificity",
  "powered_by": "PQS — promptqualityscore.com",
  "suggestion": {
    "message": "This prompt scored 9/80 (F) — significant room to improve. The optimize_prompt tool rewrites it and shows side-by-side outputs from a frontier model, so you can see the impact. optimize_prompt is part of PQS Pro ($19.99/mo, 1,000 calls/mo). Subscribe at https://promptqualityscore.com/pricing?utm_source=mcp&utm_medium=suggestion_v140&utm_campaign=2026-05-mcp-tools-v140.",
    "next_tool": "optimize_prompt",
    "subscribe_url": "https://promptqualityscore.com/pricing?utm_source=mcp&utm_medium=suggestion_v140&utm_campaign=2026-05-mcp-tools-v140"
  }
}

IP ごとのレート制限に達した場合、登録 URL とアカウント URL を含む、構造化された rate_limit_exceeded ペイロードが返されます。

optimize_prompt（Pro サブスクリプションが必要）

プロンプトを書き換えてスコアを向上させ、両方のバージョンを最先端モデルで実行することで、ユーザーが実行前後の出力を確認できるようにします。最適化されたプロンプト、最適化前後の次元別スコア（合計を含む）、improvement_pct、および並べて比較できるサンプル出力を返します。

Pro サブスクリプションが必要です（月額 $19.99、月 1,000 回の呼び出し、バッチ処理と A/B 比較を含む）。 promptqualityscore.com/pricing で登録してください。

API キーがない場合、無効な場合、または Free プランの場合、ツールは適切な URL を案内する構造化エラーを返します。エラーを黙って無視したり、キーを捏造したりすることはありません。出力されるエラー：

• api_key_required：api_key 引数が送信されていません
• api_key_invalid：キーが認識されません
• subscription_required：キーは有効ですが、Free プランです（アップグレードするには登録してください）
• rate_limited：1 分あたりのバースト制限に達した場合（Pro では月単位ではなく、分単位でレート制限されます）、または一時的に上流の処理能力が不足している場合
• service_unavailable：上流から 5xx エラーが返されました

品質ゲートパターン

推論前の品質ゲートとして PQS を使用します：

const score = await fetch("https://promptqualityscore.com/api/score/free", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: userPrompt })
});
const { score: pqsScore } = await score.json();
if (pqsScore < 56) throw new Error("Prompt quality too low. Improve and retry.");

評価が D 以下（56/80 未満）の場合、プロンプトによって推論コストが無駄になります。

x402（従来の従量課金）

このパッケージの MCP ツールは、SaaS の API キーモデルを使用しています。x402 ネイティブの従量課金方式は、正規の PQS HTTP API を通じて別途利用できます（API キー不要、呼び出し元が Base 上で USDC をオンチェーン決済します）。x402 との統合については、promptqualityscore.com にある正規の価格情報とディスカバリー用アーティファクトをご覧ください。

セルフホスト

PQS_BASE 環境変数を使用して、PQS バックエンドの URL を上書きします：

PQS_BASE=https://your-pqs-host.example.com npx pqs-mcp-server

デフォルトは https://promptqualityscore.com です。

開発元

OnChainIntel、@OnChainAIIntel promptqualityscore.com