mirror of
https://github.com/DayuanJiang/next-ai-draw-io.git
synced 2026-01-02 22:32:27 +08:00
439bdd4577
* feat: add MCP server package for npx distribution - Self-contained MCP server with embedded HTTP server - Real-time browser preview via draw.io iframe - Tools: start_session, display_diagram, edit_diagram, get_diagram, export_diagram - Port retry limit (6002-6020) and session TTL cleanup (1 hour) - Published as @next-ai-drawio/mcp-server on npm * chore: bump version to 0.1.2 * docs: add MCP server section to README (preview feature) * docs: add multi-client installation instructions for MCP server * fix: exclude packages from Next.js build * docs: use @latest instead of -y flag for npx (match Playwright MCP style) * chore: bump version to 0.4.3 and add release notes * chore: remove release notes * feat: add MCP server notice to example panel
282 lines
14 KiB
Markdown
282 lines
14 KiB
Markdown
# Next AI Draw.io
|
||
|
||
<div align="center">
|
||
|
||
**AI搭載のダイアグラム作成ツール - チャット、描画、可視化**
|
||
|
||
[English](../README.md) | [中文](./README_CN.md) | 日本語
|
||
|
||
[](https://next-ai-drawio.jiang.jp/)
|
||
|
||
[](https://opensource.org/licenses/Apache-2.0)
|
||
[](https://nextjs.org/)
|
||
[](https://react.dev/)
|
||
[](https://github.com/sponsors/DayuanJiang)
|
||
|
||
[](https://next-ai-drawio.jiang.jp/)
|
||
|
||
</div>
|
||
|
||
AI機能とdraw.ioダイアグラムを統合したNext.jsウェブアプリケーションです。自然言語コマンドとAI支援の可視化により、ダイアグラムを作成、修正、強化できます。
|
||
|
||
https://github.com/user-attachments/assets/b2eef5f3-b335-4e71-a755-dc2e80931979
|
||
|
||
## 目次
|
||
- [Next AI Draw.io](#next-ai-drawio)
|
||
- [目次](#目次)
|
||
- [例](#例)
|
||
- [機能](#機能)
|
||
- [MCPサーバー（プレビュー）](#mcpサーバープレビュー)
|
||
- [はじめに](#はじめに)
|
||
- [オンラインで試す](#オンラインで試す)
|
||
- [Dockerで実行（推奨）](#dockerで実行推奨)
|
||
- [インストール](#インストール)
|
||
- [デプロイ](#デプロイ)
|
||
- [マルチプロバイダーサポート](#マルチプロバイダーサポート)
|
||
- [仕組み](#仕組み)
|
||
- [プロジェクト構造](#プロジェクト構造)
|
||
- [サポート＆お問い合わせ](#サポートお問い合わせ)
|
||
- [スター履歴](#スター履歴)
|
||
|
||
## 例
|
||
|
||
以下はいくつかのプロンプト例と生成されたダイアグラムです：
|
||
|
||
<div align="center">
|
||
<table width="100%">
|
||
<tr>
|
||
<td colspan="2" valign="top" align="center">
|
||
<strong>アニメーションTransformerコネクタ</strong><br />
|
||
<p><strong>プロンプト：</strong> **アニメーションコネクタ**付きのTransformerアーキテクチャ図を作成してください。</p>
|
||
<img src="../public/animated_connectors.svg" alt="アニメーションコネクタ付きTransformerアーキテクチャ" width="480" />
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<strong>GCPアーキテクチャ図</strong><br />
|
||
<p><strong>プロンプト：</strong> **GCPアイコン**を使用してGCPアーキテクチャ図を生成してください。この図では、ユーザーがインスタンス上でホストされているフロントエンドに接続します。</p>
|
||
<img src="../public/gcp_demo.svg" alt="GCPアーキテクチャ図" width="480" />
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<strong>AWSアーキテクチャ図</strong><br />
|
||
<p><strong>プロンプト：</strong> **AWSアイコン**を使用してAWSアーキテクチャ図を生成してください。この図では、ユーザーがインスタンス上でホストされているフロントエンドに接続します。</p>
|
||
<img src="../public/aws_demo.svg" alt="AWSアーキテクチャ図" width="480" />
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<strong>Azureアーキテクチャ図</strong><br />
|
||
<p><strong>プロンプト：</strong> **Azureアイコン**を使用してAzureアーキテクチャ図を生成してください。この図では、ユーザーがインスタンス上でホストされているフロントエンドに接続します。</p>
|
||
<img src="../public/azure_demo.svg" alt="Azureアーキテクチャ図" width="480" />
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<strong>猫のスケッチ</strong><br />
|
||
<p><strong>プロンプト：</strong> かわいい猫を描いてください。</p>
|
||
<img src="../public/cat_demo.svg" alt="猫の絵" width="240" />
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</div>
|
||
|
||
## 機能
|
||
|
||
- **LLM搭載のダイアグラム作成**：大規模言語モデルを活用して、自然言語コマンドで直接draw.ioダイアグラムを作成・操作
|
||
- **画像ベースのダイアグラム複製**：既存のダイアグラムや画像をアップロードし、AIが自動的に複製・強化
|
||
- **PDFとテキストファイルのアップロード**：PDFドキュメントやテキストファイルをアップロードして、既存のドキュメントからコンテンツを抽出し、ダイアグラムを生成
|
||
- **AI推論プロセス表示**：サポートされているモデル（OpenAI o1/o3、Gemini、Claudeなど）のAIの思考プロセスを表示
|
||
- **ダイアグラム履歴**：すべての変更を追跡する包括的なバージョン管理。AI編集前のダイアグラムの以前のバージョンを表示・復元可能
|
||
- **インタラクティブなチャットインターフェース**：AIとリアルタイムでコミュニケーションしてダイアグラムを改善
|
||
- **クラウドアーキテクチャダイアグラムサポート**：クラウドアーキテクチャダイアグラムの生成を専門的にサポート（AWS、GCP、Azure）
|
||
- **アニメーションコネクタ**：より良い可視化のためにダイアグラム要素間に動的でアニメーション化されたコネクタを作成
|
||
|
||
## MCPサーバー（プレビュー）
|
||
|
||
> **プレビュー機能**：この機能は実験的であり、変更される可能性があります。
|
||
|
||
MCP（Model Context Protocol）を介して、Claude Desktop、Cursor、VS CodeなどのAIエージェントでNext AI Draw.ioを使用できます。
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"drawio": {
|
||
"command": "npx",
|
||
"args": ["@next-ai-drawio/mcp-server@latest"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### Claude Code CLI
|
||
|
||
```bash
|
||
claude mcp add drawio -- npx @next-ai-drawio/mcp-server@latest
|
||
```
|
||
|
||
Claudeにダイアグラムの作成を依頼：
|
||
> 「ログイン、MFA、セッション管理を含むユーザー認証のフローチャートを作成してください」
|
||
|
||
ダイアグラムがリアルタイムでブラウザに表示されます！
|
||
|
||
詳細は[MCPサーバーREADME](../packages/mcp-server/README.md)をご覧ください（VS Code、Cursorなどのクライアント設定も含む）。
|
||
|
||
## はじめに
|
||
|
||
### オンラインで試す
|
||
|
||
インストール不要！デモサイトで直接お試しください：
|
||
|
||
[](https://next-ai-drawio.jiang.jp/)
|
||
|
||
> 注意：アクセス数が多いため、デモサイトでは現在 minimax-m2 モデルを使用しています。最高の結果を得るには、Claude Sonnet 4.5 または Claude Opus 4.5 でのセルフホスティングをお勧めします。
|
||
|
||
> **自分のAPIキーを使用**：自分のAPIキーを使用することで、デモサイトの利用制限を回避できます。チャットパネルの設定アイコンをクリックして、プロバイダーとAPIキーを設定してください。キーはブラウザのローカルに保存され、サーバーには保存されません。
|
||
|
||
### Dockerで実行（推奨）
|
||
|
||
ローカルで実行したいだけなら、Dockerを使用するのが最も簡単です。
|
||
|
||
まず、Dockerをインストールしていない場合はインストールしてください：[Dockerを入手](https://docs.docker.com/get-docker/)
|
||
|
||
次に実行：
|
||
|
||
```bash
|
||
docker run -d -p 3000:3000 \
|
||
-e AI_PROVIDER=openai \
|
||
-e AI_MODEL=gpt-4o \
|
||
-e OPENAI_API_KEY=your_api_key \
|
||
ghcr.io/dayuanjiang/next-ai-draw-io:latest
|
||
```
|
||
|
||
または env ファイルを使用：
|
||
|
||
```bash
|
||
cp env.example .env
|
||
# .env を編集して設定を入力
|
||
docker run -d -p 3000:3000 --env-file .env ghcr.io/dayuanjiang/next-ai-draw-io:latest
|
||
```
|
||
|
||
ブラウザで [http://localhost:3000](http://localhost:3000) を開いてください。
|
||
|
||
環境変数はお好みのAIプロバイダー設定に置き換えてください。利用可能なオプションについては[マルチプロバイダーサポート](#マルチプロバイダーサポート)を参照してください。
|
||
|
||
> **オフラインデプロイ：** `embed.diagrams.net` がブロックされている場合は、[オフラインデプロイガイド](./offline-deployment.md) で設定オプションをご確認ください。
|
||
|
||
### インストール
|
||
|
||
1. リポジトリをクローン：
|
||
|
||
```bash
|
||
git clone https://github.com/DayuanJiang/next-ai-draw-io
|
||
cd next-ai-draw-io
|
||
```
|
||
|
||
2. 依存関係をインストール：
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
3. AIプロバイダーを設定：
|
||
|
||
ルートディレクトリに`.env.local`ファイルを作成：
|
||
|
||
```bash
|
||
cp env.example .env.local
|
||
```
|
||
|
||
`.env.local`を編集して選択したプロバイダーを設定：
|
||
|
||
- `AI_PROVIDER`を選択したプロバイダーに設定（bedrock, openai, anthropic, google, azure, ollama, openrouter, deepseek, siliconflow）
|
||
- `AI_MODEL`を使用する特定のモデルに設定
|
||
- プロバイダーに必要なAPIキーを追加
|
||
- `TEMPERATURE`：オプションの温度設定（例：`0`で決定論的な出力）。温度をサポートしないモデル（推論モデルなど）では設定しないでください。
|
||
- `ACCESS_CODE_LIST` アクセスパスワード（オプション）。カンマ区切りで複数のパスワードを指定できます。
|
||
|
||
> 警告：`ACCESS_CODE_LIST`を設定しない場合、誰でもデプロイされたサイトに直接アクセスできるため、トークンが急速に消費される可能性があります。このオプションを設定することをお勧めします。
|
||
|
||
詳細な設定手順については[プロバイダー設定ガイド](./ai-providers.md)を参照してください。
|
||
|
||
4. 開発サーバーを起動：
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
5. ブラウザで[http://localhost:3000](http://localhost:3000)を開いてアプリケーションを確認。
|
||
|
||
## デプロイ
|
||
|
||
Next.jsアプリをデプロイする最も簡単な方法は、Next.jsの作成者による[Vercelプラットフォーム](https://vercel.com/new)を使用することです。
|
||
|
||
詳細は[Next.jsデプロイメントドキュメント](https://nextjs.org/docs/app/building-your-application/deploying)をご覧ください。
|
||
|
||
または、このボタンでデプロイできます：
|
||
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FDayuanJiang%2Fnext-ai-draw-io)
|
||
|
||
ローカルの`.env.local`ファイルと同様に、Vercelダッシュボードで**環境変数を設定**してください。
|
||
|
||
|
||
## マルチプロバイダーサポート
|
||
|
||
- AWS Bedrock（デフォルト）
|
||
- OpenAI
|
||
- Anthropic
|
||
- Google AI
|
||
- Azure OpenAI
|
||
- Ollama
|
||
- OpenRouter
|
||
- DeepSeek
|
||
- SiliconFlow
|
||
|
||
AWS BedrockとOpenRouter以外のすべてのプロバイダーはカスタムエンドポイントをサポートしています。
|
||
|
||
📖 **[詳細なプロバイダー設定ガイド](./ai-providers.md)** - 各プロバイダーの設定手順をご覧ください。
|
||
|
||
**モデル要件**：このタスクは厳密なフォーマット制約（draw.io XML）を持つ長文テキスト生成を伴うため、強力なモデル機能が必要です。Claude Sonnet 4.5、GPT-4o、Gemini 2.0、DeepSeek V3/R1を推奨します。
|
||
|
||
注：`claude-sonnet-4-5`はAWSロゴ付きのdraw.ioダイアグラムで学習されているため、AWSアーキテクチャダイアグラムを作成したい場合は最適な選択です。
|
||
|
||
|
||
## 仕組み
|
||
|
||
本アプリケーションは以下の技術を使用しています：
|
||
|
||
- **Next.js**：フロントエンドフレームワークとルーティング
|
||
- **Vercel AI SDK**（`ai` + `@ai-sdk/*`）：ストリーミングAIレスポンスとマルチプロバイダーサポート
|
||
- **react-drawio**：ダイアグラムの表現と操作
|
||
|
||
ダイアグラムはdraw.ioでレンダリングできるXMLとして表現されます。AIがコマンドを処理し、それに応じてこのXMLを生成または変更します。
|
||
|
||
## プロジェクト構造
|
||
|
||
```
|
||
app/ # Next.js App Router
|
||
api/chat/ # AIツール付きチャットAPIエンドポイント
|
||
page.tsx # DrawIO埋め込み付きメインページ
|
||
components/ # Reactコンポーネント
|
||
chat-panel.tsx # ダイアグラム制御付きチャットインターフェース
|
||
chat-input.tsx # ファイルアップロード付きユーザー入力コンポーネント
|
||
history-dialog.tsx # ダイアグラムバージョン履歴ビューア
|
||
ui/ # UIコンポーネント（ボタン、カードなど）
|
||
contexts/ # Reactコンテキストプロバイダー
|
||
diagram-context.tsx # グローバルダイアグラム状態管理
|
||
lib/ # ユーティリティ関数とヘルパー
|
||
ai-providers.ts # マルチプロバイダーAI設定
|
||
utils.ts # XML処理と変換ユーティリティ
|
||
public/ # サンプル画像を含む静的アセット
|
||
```
|
||
|
||
## サポート＆お問い合わせ
|
||
|
||
このプロジェクトが役に立ったら、ライブデモサイトのホスティングを支援するために[スポンサー](https://github.com/sponsors/DayuanJiang)をご検討ください！
|
||
|
||
サポートやお問い合わせについては、GitHubリポジトリでissueを開くか、メンテナーにご連絡ください：
|
||
|
||
- メール：me[at]jiang.jp
|
||
|
||
## スター履歴
|
||
|
||
[](https://www.star-history.com/#DayuanJiang/next-ai-draw-io&type=date&legend=top-left)
|
||
|
||
---
|