prompyai

prompyai-mcp

Claude CLI 向けのコンテキスト認識型プロンプトインテリジェンス MCP サーバーです。実際のコードベースに照らしてプロンプトを評価し、AI で書き換えます。

インストール

claude mcp add prompyai -- npx prompyai-mcp serve

サインアップ不要。設定不要。すぐに使えます。Node.js 20 以降が必要です。

できること

Claude CLI でプロンプトを入力するたびに、PrompyAI が自動で次の処理を行います。

1. 評価します（0～100 点）。具体性、コンテキストの完全性、タスクの明確さ、ファイルとフォルダーによる指定の観点で評価します。
2. プロジェクトに合わせた改善案を提案します。
3. 実際のファイルパス、検証済みのシンボル、コードベースのコンテキストを使ってプロンプトを書き換えます。

Prompt Score: 43/100 [D]

  Specificity         3/25  ==..............
  Context Completeness 13/25  ========........
  Task Clarity        15/25  =========.......
  File & Folder Anchoring 10/25  ======..........

Key improvements:
  1. Expand your prompt with more context
  2. Add file paths using @mentions
  3. Specify what format you expect the output in

Try something more like:

  "Build the VS Code extension in packages/vscode-extension/ that integrates
   with the PrompyAI MCP server at packages/mcp-server/. It should provide
   real-time prompt scoring in the editor sidebar, show score breakdowns
   (specificity, context, clarity, anchoring), and offer a 'rewrite prompt'
   action. Use the shared types from packages/shared/."

AI による強化 — すべてのユーザーが利用可能

PrompyAI は、2 層アーキテクチャを採用しています。

• API キーを使用するユーザー（ANTHROPIC_API_KEY を設定済み）→ PrompyAI が Claude Haiku を直接呼び出し、高速に AI による書き換えを行います。
• サブスクリプションを使用するユーザー（API キーなし）→ PrompyAI が豊富なコードベースのコンテキストを Claude に返し、既存のセッションを使って Claude が強化済みプロンプトを生成します。

すべてのユーザーが AI による強化済みの出力を利用できます。別途 API キーを用意する必要はありません。

コードベースを把握する方法

PrompyAI はプロジェクトをローカルでインデックス化します。

• ファイルツリー — 構造、主要なフォルダー、最近変更されたファイル
• 技術スタック — 言語、フレームワーク、ORM、テストランナーを検出
• コードシンボル — TypeScript Compiler API を使って関数、クラス、インターフェースを抽出
• Git の状態 — ブランチ、変更のあるファイル、最近の変更
• セッション履歴 — 複数ターンのコンテキストを得るため、Claude Code の会話トランスクリプトを読み込みます

インデックス化はすべてローカルで行われます。外部に送信される情報はありません（任意の匿名テレメトリを除く）。

MCP ツール

evaluate_prompt

すべてのユーザーメッセージに対して自動で呼び出されます。プロンプトをプロジェクトに照らして評価します。

パラメーター	必須	説明
prompt	はい	評価するプロンプトのテキスト
workspace_path	はい	プロジェクトの絶対パス
active_file	いいえ	現在開いているファイルのパス
session_id	いいえ	複数ターンのコンテキスト用の Claude Code セッション ID

get_context

技術スタック、最近のファイル、主要なフォルダーなど、プロジェクトの概要を返します。

パラメーター	必須	説明
workspace_path	はい	プロジェクトの絶対パス

prompyai_toggle

自動評価をオンまたはオフにします。Claude CLI で「pause prompyai」または「enable prompyai」と入力してください。

デスクトップ設定

または、~/.claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "prompyai": {
      "command": "npx",
      "args": ["prompyai-mcp", "serve"]
    }
  }
}

環境変数

変数	必須	説明
ANTHROPIC_API_KEY	いいえ	Claude Haiku 経由の直接的な AI 提案を有効にします（任意）
PROMPYAI_TELEMETRY	いいえ	匿名テレメトリを無効にするには false を設定します

CLI コマンド

prompyai serve              # Start the MCP server (default)
prompyai doctor             # Run environment diagnostics
  --workspace <path>        # Workspace to check (default: cwd)

プログラムからの API 利用

import { WorkspaceIndexer, ScoringEngine } from 'prompyai-mcp';

const indexer = new WorkspaceIndexer();
const scorer = new ScoringEngine();

const fingerprint = await indexer.getFingerprint('/path/to/project');
const result = await scorer.evaluate('fix the auth', fingerprint);

console.log(result.display); // Pre-formatted score output
console.log(result.total);   // 0-100
console.log(result.grade);   // A-F

リンク

• ウェブサイト： prompyai.com
• GitHub： github.com/samouh-waleed/PrompyAI
• MCP レジストリ： io.github.samouh-waleed/prompyai

ライセンス

MIT