Conducted MCP

Conducted MCP

規律あるチームと同じように、AI エージェントがソフトウェアプロジェクトを計画し、進捗を追跡できるよう支援する MCP サーバーです。しかも、このツールが提供する手法を使って開発されました。

Conducted MCP は、軽量で意図を重視する手法であるConducted Developmentを、MCP 対応のあらゆるエージェント（Claude Desktop、Cursor など）に提供します。これはステートレスなアドバイザー兼バリデーターです。プロジェクトのデータを保持せず、ファイルや git に触れることもありません。I/O はエージェントがすべて行い、サーバーは判断を提供します。成果物を検証する、このスタンドアップの実施時期か、フェーズの手順は何か、この決定はログに記録すべきか、といった判断です。

他との違い： このリポジトリの work/ フォルダーにある目標概要、意図ドキュメント、意思決定ログ、サイクルのスタンドアップは、このツールが実装する手法に 従って 作成されました。これはサンプルではなく、プロセスの実証です。

---

できること

接続したエージェントは、必要に応じて次の機能を利用できます。

• ガイド付きのキックオフ（kickoff プロンプトと kickoff_questions ／ kickoff_plan ツール） — 新規プロジェクトにも既存のコードベースにも対応し、プロジェクトの計画構造を立ち上げるための分岐型 Q&A です。既存のコードについては、エージェントがリポジトリを調査し、サーバーが回答を事前入力するため、人間は一から作成するのではなく内容を確認できます。
• 厳格な成果物検証（validate_artifact） — 目標概要、意図ドキュメント、セッションログ、スタンドアップを送信すると、{ valid, missing, warnings } が返されます。
• フェーズごとの手順（next_procedure） — エージェントがループのどの段階にいるかに応じて、順序立てた手順、最初に読むもの、エスカレーションのポイントを提示します。
• 機械的なルールチェック（standup_due、evaluate_gate、decision_log_guidance） — 1 人で取り組む実践者が最も見落としがちな習慣について、提供された事実に基づきステートレスに判断します。

この手法のガイド、テンプレート、規約は、読み取り専用のリソース（conducted://guide/*、conducted://template/*、conducted://conventions）として提供されるため、エージェントは同じやり取りの中でルールを学ぶことができます。

---

この設計にした理由（Model C）

サーバーは強制できません。エージェントは常にファイルに直接アクセスできるためです。そのため、ゲートキーパーのように振る舞うのではなく、アドバイザーとして設計されています。判断や手順を返す純粋関数であり、副作用はありません。データもデータへの認証もない状態でホストするものはありません。この設計により、移植性が高く、簡単にテストでき、ローカルでもリモートでも低コストで実行できます。その考え方は docs/DESIGN_SKETCH.md に記載されており、検討の結果採用したトレードオフは DECISIONS.md にまとめられています。

---

クイックスタート

npm で conducted-mcp として公開されており、インストール不要で npx から実行できます。

MCP クライアントにサーバーを追加します。Claude Desktop（claude_desktop_config.json）または Cursor（.cursor/mcp.json）を使用します。

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

次に、エージェントに「このプロジェクトで Conducted のキックオフを実行して」と依頼するか、任意のツールを直接呼び出します。

またはホスト済みエンドポイントに接続する（インストール不要）

Cloudflare Workers 上で、ステートレスな Streamable HTTP エンドポイントが稼働しています。URL で接続でき、インストールは不要です。

{
  "mcpServers": {
    "conducted": {
      "url": "https://conducted-mcp.jonathanmostov.workers.dev/mcp"
    }
  }
}

サーバーはステートレスでデータを保持しないため（Model C）、エンドポイントはレート制限で保護することで、認証なしでも安全に実行できます。

---

デモ

kickoff の流れを実際に記録したトランスクリプト（最初のプロンプト、分岐型インタビュー、フェーズごとの手順）を、稼働中のサーバーから一字一句そのまま収録した docs/DEMO.md をご覧ください。

---

開発

npm install
npm run build     # bundles the methodology text, then strict tsc
npm test          # vitest
npm run lint      # eslint + prettier
npm start         # run the stdio server

サーバーは公式の @modelcontextprotocol/sdk を使用した TypeScript で、ESM と strict mode を採用しています。構成と規約については CONTRIBUTING.md をご覧ください。

---

リポジトリ内の方法論

• work/goal-briefs/ — このビルドの指針となったゴールブリーフ
• work/intent-docs/ — チケットごと、セッションごとの契約
• work/standups/ — サイクルゲートのスタンドアップ
• work/decision-log.md — 追記専用の決定記録
• AGENT_CONVENTIONS.md — モデルやツールに依存しない、各セッションの進め方

---

ライセンス

MIT © 2026 Jonathan Mostov