draftlytic-mcp

draftlytic-mcp

大まかなプロジェクトのアイデアを構造化された仕様書に変換する MCP サーバーです。Claude Code、Cursor、または MCP 対応のエディター上でそのまま使えます。API キーもアカウントもネットワーク通信も不要です。すべてお使いのマシン上で動作し、エディターのモデルに、記入用のスキーマ、確認事項のチェックリスト、コーディング開始前に抜け漏れを検出するバリデーター、そして結果を見やすい Markdown の PRD に変換するレンダラーを提供します。

これを開発したのは、1 行のプロンプトから始める「バイブコーディング」では、もっともらしく見えても、実際に決めておくべきことの半分が抜けたアプリができがちだからです。たとえば、v1 の対象範囲、データモデルの構成、機能の「完了」の定義などです。draftlytic-mcp がこうした内容を代わりに生成することはありません。代わりに、モデルが適切な質問をできるように会話を構成し、構築を始める前に回答内容を自ら確認できるようにします。

インストール

Claude Code

claude mcp add draftlytic -- npx -y draftlytic-mcp

Cursor

プロジェクトの .cursor/mcp.json（またはグローバルの ~/.cursor/mcp.json）に追加します。

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

その他の MCP クライアント

ほとんどの MCP ホストは、同じ形式の汎用 mcp.json を読み込みます。

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

使い方

接続したら、エディターのモデルに次のように依頼します。

「テキストメッセージでリマインドしてくれる習慣トラッカー」のために plan_project プロンプトを使ってください

モデルが一緒に spec_checklist を進めます（プラットフォーム、技術スタック、対象ユーザー、機能、競合、収益、制約、データモデル、通知、外部サービス、デザインと UX。各カテゴリにつき具体的な質問がいくつかあり、多くの場合、空欄に入力する形式ではなく、クリックして選ぶ単一選択または複数選択肢が提示されます。いつでも自由記述で回答できます）。その後、仕様書を作成して validate_spec にかけ、指摘された箇所を修正し、レンダリングした PRD を Markdown 形式で渡します。この PRD は、コーディングエージェントへのプロンプト、SPEC.md、または GitHub Issue にそのまま貼り付けられます。

すでに仕様書を作成済みの場合（手書き、または別のソースから作成したもの）でも、ツールを直接呼び出してチェックとレンダリングだけを行えます。

ツールリファレンス

ツール	入力	動作
validate_spec	spec（JSON オブジェクト）	Zod で仕様を検証し、構造化された問題を返します。必須セクションの欠落・空欄、プレースホルダーテキスト（TBD、lorem ipsum、fixme など）、優先度が設定されていない機能に関するエラーに加え、「必須項目に受け入れ条件がありません」や「non_goals が指定されていません」といった、処理を妨げない品質に関するヒントも返します。
render_prd	spec（JSON オブジェクト）	検証済みの仕様を、タイトル、概要、対象読者、プラットフォーム、技術スタック、優先度別にまとめた機能と受け入れ条件のチェックリスト、画面とナビゲーション、データモデルの表、制約、非目標を含む決定論的な Markdown にレンダリングします。構造上のエラーがある場合、レンダリングを拒否してエラーを返します。
spec_checklist	—	カテゴリ別にまとめたプランニング用チェックリストを返します。各カテゴリには、具体的な質問が 2～4 件含まれます。各質問は { prompt, options?, multiSelect? } です。options がある質問は、選択可能な単一選択または複数選択式の回答として表示し、自由入力での回答も可能です。自由回答形式の質問には、自由入力で回答します。
open_in_draftlytic	spec（JSON オブジェクト、省略可）または idea（文字列）	アイデアを、概要があらかじめ入力された完全版の Draftlytic アプリで開くリンクを作成します。ガイド付きの AI 質問フロー、より充実した生成機能、編集可能な仕様エディター、PRD のエクスポート機能は、アプリ内で利用できます。仕様（部分的なものも含む）を開始用の概要に圧縮するか、プレーンテキストのアイデアを受け取ります。URL はローカルで作成され、情報が外部に送信されることはありません。

プロンプトが 1 つあります。

プロンプト	引数	動作
plan_project	idea（文字列）	モデルに対して、spec_checklist を使ってユーザーに質問し、仕様の草案を作成し、検証と修正を繰り返した後、最終的な PRD をレンダリングするよう指示します。

仕様の形式

{
  name: string
  overview: string
  target_audience: string
  platforms: string[]
  tech_stack: string[]
  features: Array<{
    title: string
    description: string
    priority: "must-have" | "nice-to-have" | "future"
    acceptance_criteria?: string[]
  }>
  screens?: Array<{ name: string; purpose: string }>
  data_model?: Array<{
    entity: string
    fields: Array<{ name: string; type: string; notes?: string }>
  }>
  constraints?: string[]
  non_goals?: string[]
  revenue_model?: string
}

正直な制限事項

• これは v1 で、完全にローカルで動作します。 裏で Draftlytic API は動いていません。各ツールはすべて、エディターのモデルから渡された仕様 JSON に対して、同期的なオフライン処理を実行します。ツール自体が AI を呼び出すことはありません。
• 文章を書くのはモデルで、これは構成を整えるだけです。 validate_spec と spec_checklist はヒューリスティックであり、実際に何を構築するのかを理解することの代わりにはなりません。検証に合格した仕様でも、計画として不適切な場合があります。
• プレースホルダーの検出はパターンベースであり、意味を理解するものではありません。 TBD／lorem ipsum／fixme のような埋め草は検出しますが、「説明は曖昧でも、技術的には実在する単語で書かれている」といったものは検出しません。
• 永続化には対応していません。 呼び出しの間に保存されるものはありません。仕様 JSON は会話内に保持されます。保存したい場合は、モデルにファイルへの書き込みを依頼してください。
• 共同作業、バージョン管理、Markdown 以外のエクスポート形式には対応していません。 これは計画ツールであり、プロジェクト管理ツールではありません。

---

draftlytic-mcp は draftlytic.com のオフライン版です。フルエディターには、AI による生成、ロゴのドラフト作成、ギャップのスキャン、GitHub へのプッシュ機能が追加されています。