Ilograph MCP Server

🎯 Ilograph MCP サーバー

Ilograph MCP サーバーは、AI エージェントに Ilograph のドキュメント、検証ツール、図の作成ガイドを包括的に提供する Model Context Protocol（MCP） サーバーです。インテリジェントな支援で、複雑なアーキテクチャドキュメントを変革できます。

ユースケース

• 図の自動作成：自然言語の説明から Ilograph の図を生成します
• リアルタイム検証：既存の図を検証し、詳細なエラー分析と提案を提供します
• ドキュメントへのアクセス：Ilograph の包括的なドキュメントとベストプラクティスをすぐに参照できます
• 学習と例：詳細な解説付きの厳選された図の例を確認できます

重要：これは非公式のコミュニティ主導プロジェクトであり、Ilograph LLC とは提携しておらず、同社から承認も受けていません。このサーバーは、一般公開されている Ilograph のドキュメントとリソースを利用し、学習と開発を支援します。

注意：MCP サーバーが提供する出力や推奨事項は動的に生成されるため、クエリやモデルによって異なる場合があります。ユーザーは、プロジェクトの要件に沿っていることを確認するためにすべての出力を十分に確認し、実装前にIlograph の公式ドキュメントと照合してください。

前提条件

1. Docker： Docker がインストールされ、実行されていること
2. MCP 対応クライアント：Claude Desktop、VS Code、Cursor など

クイックスタート

MCP クライアントに追加する

この設定を MCP クライアントに追加します。

VS Code：

以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押し、「Preferences: Open User Settings (JSON)」と入力すると追加できます。

VS Code のエージェントモードで MCP サーバーツールを使用する方法については、ドキュメントをご覧ください。

{
  "mcp": {
    "servers": {
      "ilograph": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
        ]
      }
    }
  }
}

必要に応じて、同様の例（つまり、mcp キーなし）をワークスペース内の .vscode/mcp.json というファイルに追加できます。これにより、他のユーザーと設定を共有できます。

{
  "servers": {
    "ilograph": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
      ]
    }
  }
}

Claude Desktop / Cursor / Jetbrains AI Assistant：

{
  "mcpServers": {
    "ilograph": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"]
    }
  }
}

これで完了です！🎉

ツールの設定

利用可能なツール

Ilograph ワークフローを包括的にサポートするため、以下のツールを利用できます。

カテゴリ	ツール	説明
ドキュメント	fetch_documentation_tool	インテリジェントなキャッシュ機能を備え、Ilograph の公式ソースから包括的なドキュメントを取得します
ドキュメント	list_documentation_sections	利用可能なすべてのドキュメントセクションを、説明と対象範囲とともに一覧表示します
ドキュメント	check_documentation_health	ドキュメントサービスのヘルスチェックを実行し、キャッシュ統計を返します
仕様	fetch_spec_tool	プロパティの定義と型をすべて含む、Ilograph の公式仕様を取得します
仕様	check_spec_health	仕様サービスの接続性に特化したヘルスチェックを実行します
サンプル	list_examples	複雑さと用途別に分類された、利用可能な Ilograph サンプル図を一覧表示します
サンプル	fetch_example	メタデータ、学習コンテキスト、説明を含む特定のサンプル図を取得します
検証	validate_diagram_tool	Ilograph 図の構文を検証し、提案を含む詳細なエラーメッセージを表示します
検証	get_validation_help	図の検証と一般的な問題の解決方法について、包括的なガイダンスを提供します
アイコン	search_icons_tool	セマンティックマッチングとプロバイダーによる絞り込みを使用して、Ilograph の最新アイコンカタログを検索します
アイコン	list_icon_providers_tool	利用可能なすべてのアイコンプロバイダー（AWS、Azure、GCP など）と、そのサービスカテゴリを一覧表示します

貢献

貢献を歓迎します。このプロジェクトでは、以下を募集しています。

• 🐛 バグ修正 - いつでも歓迎します！
• 📚 ドキュメントの改善 - 内容をより分かりやすくするための改善
• ✨ 新しいツール - Ilograph の機能を追加
• 🔧 コード品質の向上 - エラーハンドリングの改善など

📖 開発環境のセットアップ、テスト、提出に関する詳細なガイドラインは、CONTRIBUTING.mdをご覧ください。

機能

• 📚 最新ドキュメントへのアクセス：Ilograph の公式ソースから最新のドキュメントを取得します
• 🔍 包括的なセクションを網羅：Ilograph の主要な概念（リソース、パースペクティブ、コンテキストなど）にアクセスできます
• ✅ 高度な図の検証：YAML と Ilograph のスキーマを検証し、提案を含む詳細なエラーメッセージを表示します
• ⚡ インテリジェントなキャッシュ：TTL ベースのキャッシュとフォールバック戦略により、パフォーマンスを最適化します
• 🛠️ ツール優先の設計：現在利用可能なすべての MCP クライアント（Cursor、Claude Desktop、VS Code など）と互換性があります
• 📋 厳選されたサンプルライブラリ：学習コンテキストと説明を含む、実際の Ilograph 図を収録しています
• 🎨 スマートアイコン検索：プロバイダーによる絞り込み機能を備え、Ilograph のアイコンカタログをセマンティック検索できます
• 🔄 ヘルスモニタリング：サービスのヘルスチェックとステータスレポートを標準搭載しています
• 🏗️ アーキテクチャパターンの検出：一般的なパターンを特定し、最適化の提案を提示します

お困りですか？

• ツールの使用方法：上の表にある利用可能なツールをご覧ください
• 問題の報告：GitHub Issues
• 質問：GitHub Discussions

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細はLICENSEファイルをご覧ください。

法的免責事項

このプロジェクトは Ilograph LLC と提携、承認、または関係していません。 教育および開発を目的として、一般公開されている Ilograph のドキュメントとリソースにアクセスする、独立したコミュニティ主導のツールです。

• Ilograph の名称と関連する商標は、Ilograph LLC の所有物です
• このツールはフェアユースの原則に基づき、一般公開されているドキュメントにアクセスします
• 正確な情報については、Ilograph の公式ドキュメントを参照してください
• このプロジェクトと Ilograph LLC の間に商業的な関係はありません

リンク

• Ilograph 公式ウェブサイト
• Ilograph ドキュメント
• Model Context Protocol
• FastMCP フレームワーク

---

Ilograph コミュニティのために ❤️ を込めて作られました