Kotlin MCP Server

🚀 エンタープライズKotlin Android MCPサーバ

このサーバは、AIエージェントにKotlinベースのAndroid開発プロジェクトへのエンタープライズグレードのアクセスを提供する包括的なモデルコンテキストプロトコル（MCP）サーバです。高度なセキュリティ、プライバシーコンプライアンス、AI統合、および包括的な開発ツールを備えたコンテキスト認識型の支援を可能にします。

---

📋 リビジョン履歴

バージョン2.1 (現在 - 2025年8月)

強化版リリース: 統合型インテリジェントサーバ

🎯 最新の改善点

• 🧠 インテリジェントツール管理: 全27のツールがLSPのような機能を持つインテリジェントプロキシシステムを使用するようになりました。
• 🔄 サーバの統合: 強化されたアーキテクチャで単一のkotlin_mcp_server.pyに統合されました。
• 📁 クリーンなアーキテクチャ: 冗長なサーババージョンがアーカイブされ、プロジェクト構造がクリーンになりました。
• ⚡ ツールの公開強化: インテリジェント管理システムを通じて完全なツールセットが適切に公開されます。
• 🛠️ ツールルーティングの改善: ネイティブ実装とインテリジェントプロキシ間のスマートな委任が行われます。

🔧 アーキテクチャの変更

• 統合サーバ: 単一のkotlin_mcp_server.pyが複数のサーババージョンを置き換えます。
• インテリジェントプロキシシステム: 完全な実装がないツールは、AI強化されたスマートプロキシを使用します。
• クリーンなファイル構造: レガシーサーバはarchive/legacy-servers/にアーカイブされます。
• 強化されたツールマネージャ: IntelligentMCPToolManagerとの統合により、高度な機能が実現されます。
• 完全なツールカバレッジ: 全32のツールが適切に公開され、機能します。

📊 ツールの実装状況

• 完全に実装: 6つのツール (format_code, run_lint, generate_docs, create_compose_component, setup_mvvm_architecture, security_hardening)
• レガシー統合: 3つのコアツール (create_kotlin_file, gradle_build, analyze_project)
• インテリジェントプロキシ: 23のツールがスマートなフォールバック実装を持ちます。
• 合計利用可能: 32のツールで包括的なAndroid開発をカバーします。

バージョン2.0 (2025年8月)

主要リリース: AI強化型モジュールアーキテクチャ

🎯 主要な改善点

• 🤖 AI統合: テンプレートジェネレータからAIパワードの開発アシスタントに変換されました。
• 🏗️ モジュールアーキテクチャ: モノリシック構造が6つの専用モジュールにリファクタリングされました。
• 🌍 動的構成: すべてのハードコードされたパスが削除され、クロスプラットフォームの移植性が向上しました。
• ⚡ 強化されたツール: 30から31のツールに拡張され、AI強化された実装が追加されました。
• 🛡️ セキュリティ強化: 設定可能な監査トレイルとコンプライアンス監視が追加されました。
• 📦 ゼロコンフィグ設定: 自動環境検出機能を持つインテリジェントインストーラーが導入されました。

🔧 技術的な変更

• モジュール設計: ai/, android/, gradle/, security/, testing/, utils/のモジュールに分割されました。
• AIパワードのコード生成: LLMを呼び出して本番環境で使用可能なコード（TODOなし）を生成します。
• 環境変数のサポート: すべての構成が動的な環境変数を使用するようになりました。
• クロスプラットフォームパス: 汎用的な~表記がOS固有のハードコードされたパスを置き換えます。
• 強化されたエラーハンドリング: 包括的な検証とグレースフルなエラー回復が実装されました。
• パフォーマンス最適化: より良いリソース管理によりツールの実行が効率化されました。

📊 移行の影響

• ツール: 30 → 32のツール (107%の機能同等性 + 強化)
• ファイルサイズ: モノリシックアプローチに比べて最適化されたモジュール構造。
• 構成: 手動でのパス構成は不要になりました。
• 互換性: 既存のセットアップとの完全な下位互換性が維持されます。

バージョン1.0 (レガシー - 2025年8月以前)

初期リリース: テンプレートベースのコードジェネレータ

• ✅ 30のツールを持つ基本的なMCPサーバ
• ✅ テンプレートベースのKotlin/Androidコード生成
• ✅ ハードコードされたパスを持つ手動構成
• ✅ モノリシックアーキテクチャ
• ✅ 基本的なセキュリティとコンプライアンス機能

---

🌟 エンタープライズ機能の概要

🔒 セキュリティとプライバシーコンプライアンス

• GDPRコンプライアンス - 同意管理、データ可搬性、消去権を含む完全な実装
• HIPAAコンプライアンス - 監査ロギング、アクセス制御、暗号化を備えた医療グレードのセキュリティ
• データ暗号化 - 敏感なデータに対するAES-256暗号化とPBKDF2キー導出
• 監査トレイル - コンプライアンスフラグとセキュリティイベント追跡を含む包括的なロギング
• デザイン時プライバシー - すべての操作に組み込まれたプライバシー保護

🤖 AI/ML統合

• ローカルLLMサポート - Ollama、LocalAI、およびセルフホスト型のトランスフォーマー
• 外部LLM API - OpenAI GPT-4、Anthropic Claude、カスタムエンドポイント
• AIパワードのコード分析 - セキュリティ、パフォーマンス、および複雑性分析
• インテリジェントコード生成 - コンテキスト認識型のKotlin/Androidコード作成
• MLモデル統合 - Androidアプリ用のTensorFlow Lite、ONNX、PyTorch Mobile

📁 高度なファイル管理

• エンタープライズファイル操作 - バックアップ、復元、同期、暗号化、復号化を監査トレイル付きで行います。
• リアルタイム同期 - 自動同期機能を持つファイルシステムウォッチャー
• クラウドストレージ統合 - AWS S3、Google Cloud、Azureとのエンドツーエンドの暗号化付き統合
• スマートファイル分類 - 自動的な敏感データ検出と暗号化
• バージョン管理 - 競合解決機能を持つGit対応操作

🌐 外部API統合

• 包括的な認証サポート - APIキー、OAuth 2.0、JWT、基本認証
• セキュリティ機能 - レート制限、リクエストロギング、レスポンス検証
• リアルタイム監視 - API使用メトリクス、パフォーマンス追跡、コスト分析
• コンプライアンス検証 - GDPR/HIPAAコンプライアンスのAPI処理

🏗️ 高度なAndroid開発

• アーキテクチャパターン - MVVM、クリーンアーキテクチャ、依存性注入
• 最新のUI開発 - Jetpack Compose、カスタムビュー、複雑なレイアウト
• データベース統合 - 暗号化とマイグレーション処理を持つRoom
• ネットワーク層 - Retrofit、GraphQL、WebSocketサポート
• テストフレームワーク - 包括的なテスト生成と実行

---

🚀 クイックスタートとインストール

✨ V2.0へのアップグレードのハイライト

🤖 AI強化型開発: 今では基本的なテンプレートではなく、AIアシスタントを活用して本番環境で使用可能なコードを生成します！

以前 (V1.0):

• ❌ TODOプレースホルダーを含むテンプレートベースのコード
• ❌ 設定ファイルでの手動パス編集
• ❌ モノリシックアーキテクチャ (単一の大きなファイル)
• ❌ ハードコードされたパスとユーザー固有の構成
• ❌ 限られたAI統合を持つ30の基本ツール

以降 (V2.0):

• ✅ AIパワードのコード生成: 完全なコンテキスト認識型の実装
• ✅ ゼロコンフィグ設定: python3 install.pyですべてを自動的に設定します。
• ✅ モジュールアーキテクチャ: クリーンで保守性の高い6モジュール構造
• ✅ 動的構成: 環境変数を使用したクロスプラットフォーム対応
• ✅ 31の強化ツール: AI統合とインテリジェントエラーハンドリング

📋 システム要件

• Python 3.8以上 (3.9以上が推奨)
• pip (Pythonパッケージマネージャー)
• Git (リポジトリのクローン用)
• MCPサポート付きのIDE (VS Code、JetBrains IDE、Claude Desktop)

🔧 インストール手順

1. リポジトリのクローン

git clone <your-repo-url>
cd kotlin-mcp-server

2. 自動化されたインストールと構成

プロジェクトには、すべての構成を自動的に処理する強化されたインストールスクリプトが含まれています。

# 対話型インストール (初めてのユーザーに推奨)
python3 install.py

# 特定の構成での非対話型インストール
python3 install.py [install_type] [project_path] [server_name] [use_env_vars]

# すべての利用可能なオプションを表示
python3 install.py --help

インストールタイプ:

• 1 - ポータブル: プロジェクトディレクトリから直接実行します。
• 2 - システム: コマンドをPATHにインストールします (kotlin-android-mcp)
• 3 - モジュール: python -m kotlin_mcp_serverを有効にします。

構成例:

# 対話型セットアップ (設定を尋ねます)
python3 install.py 1

# あなたのAndroidプロジェクトパスでのポータブルインストール (実際のパスに置き換えてください)
python3 install.py 1 ~/AndroidStudioProjects/MyApp

# 動的環境変数を使用したシステムインストール
python3 install.py 2 none my-android-server true

# カスタムサーバー名でのモジュールインストール
python3 install.py 3 /path/to/project kotlin-dev false

インストーラーの機能:

• ✅ requirements.txtからすべてのPython依存関係をインストールします。
• ✅ プラットフォーム固有の設定ファイルを作成します (Claude、VS Code、汎用)
• ✅ スクリプトに適切なファイルパーミッションを設定します。
• ✅ あなたの選択に基づいて環境変数を構成します。
• ✅ 設定ファイルでの手動パス更新を不要にします。
• ✅ あなたのセットアップに対する明確な統合手順を提供します。

3. 手動インストール (代替案)

手動インストールを好む場合は、以下の手順を実行します。

# コア依存関係をインストール
pip install -r requirements.txt

# オプション: 高度な機能のためのAI/ML依存関係をインストール
pip install openai anthropic transformers torch

# インストールを確認
python3 -c "import kotlin_mcp_server; print('✅ インストール成功')"

インストールされる主要な依存関係:

• コアMCP: python-dotenv, pydantic
• セキュリティ: cryptography, bcrypt, PyJWT
• データベース: aiosqlite, sqlalchemy
• HTTPクライアント: aiohttp, httpx
• ファイル管理: aiofiles, watchdog
• テスト: pytest, pytest-asyncio, coverage
• コード品質: black, flake8, pylint, mypy
• セキュリティツール: bandit, safety

4. V2.0のアーキテクチャとツールの強化

🏗️ モジュールアーキテクチャ設計

V2.0リリースでは、クリーンで保守性の高いモジュール構造が導入されました。

kotlin-mcp-server/
├── kotlin_mcp_server.py      # メインサーバ (32のAI強化ツール)
├── ai/
│   ├── llm_integration.py    # AIアシスタントの統合
│   └── code_enhancement.py   # AIパワードのコード生成
├── android/
│   ├── project_manager.py    # プロジェクト構造管理  
│   └── manifest_utils.py     # Androidマニフェスト操作
├── gradle/
│   ├── build_system.py       # Gradleビルド自動化
│   └── dependency_manager.py # 依存関係解決
├── security/
│   ├── compliance.py         # GDPR/HIPAAコンプライアンス
│   └── encryption.py         # データ保護
├── testing/
│   └── test_generator.py     # 自動テスト作成
└── utils/
    ├── file_operations.py    # 強化されたファイル管理
    └── security.py           # 監査トレイルとロギング

🤖 AI強化型ツールの機能

ツールカテゴリ	V1.0 (テンプレート)	V2.0 (AI強化)
コード生成	TODOを含む基本的なテンプレート	本番環境で使用可能なコンテキスト認識型の実装
アーキテクチャパターン	スケルトンコード	完全なMVVM、クリーンアーキテクチャパターン
UIコンポーネント	静的なレイアウト	ビジネスロジックを含む動的なJetpack Compose
データベース操作	スキーマテンプレート	マイグレーションを含む完全なRoom実装
テスト	テストスタブ	エッジケースを含む包括的なテストスイート
セキュリティ	基本的な検証	コンプライアンスを備えたエンタープライズグレードのセキュリティ

⚡ パフォーマンスと信頼性の改善

• 31のツール (V1.0の30に比べて) で強化されたAI統合
• エラー回復: AIサービスの中断に対するグレースフルなハンドリング
• コンテキスト認識: ツールがプロジェクト構造と要件を理解します。
• リソース最適化: 効率的なメモリ使用と高速な実行
• クロスプラットフォームサポート: 汎用的な構成システム

5. IDE統合セットアップ

インストール後、スクリプトはすぐに使用できる設定ファイルを生成します。

• mcp_config_claude.json - Claude Desktop用
• mcp_config_vscode.json - VS CodeとCursor用
• mcp_config.json - その他のMCPクライアント用

統合手順:

🔹 Claude Desktop: mcp_config_claude.jsonの内容を以下にコピーします。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

🔹 VS Code/Cursor: あなたのVS Codeのsettings.jsonに追加します。

{
  "mcp.server.configFiles": [
    "/absolute/path/to/mcp_config_vscode.json"
  ]
}

🔹 その他のIDE: mcp_config.jsonをあなたのMCPクライアントで使用します。

5. 環境構成 (高度な設定)

高度なユーザーがカスタム環境セットアップを必要とする場合は、プロジェクトルートに.envファイルを作成します (高度な構成でのみ必要)。

# サンプルファイルをコピーしてカスタマイズ
cp .env.example .env

# あなたの設定で編集
nano .env  # またはあなたが好きなエディターを使用

オプションの変数:

# セキュリティ (強力なパスワードを生成)
MCP_ENCRYPTION_PASSWORD=$(openssl rand -base64 32)
COMPLIANCE_MODE=gdpr,hipaa

# オプション: AI統合
OPENAI_API_KEY=your-openai-api-key-here
ANTHROPIC_API_KEY=your-anthropic-api-key-here

💡 注意: インストールスクリプトは自動的にプロジェクトパスとサーバー設定を構成するため、手動の環境構成はAI統合やカスタムセキュリティ設定などの高度な機能でのみ必要です。

6. 必要なIDE拡張機能/プラグインのインストール

IDE固有の拡張機能については、以下のプラグイン要件セクションを参照してください。

7. インストールのテスト

# あなたの構成でサーバーをテスト
# インストール中に固定のプロジェクトパスを使用した場合:
python3 kotlin_mcp_server.py

# 動的/環境変数を使用している場合:
python3 kotlin_mcp_server.py /path/to/android/project

# システムインストールの場合:
kotlin-android-mcp

# モジュールインストールの場合:
python3 -m kotlin_mcp_server

# 構成を検証 (オプション)
python3 validate_config.py

# 包括的なテストを実行 (オプション)
python test_mcp_comprehensive.py

# VS Codeブリッジサーバーをテスト (オプション)
python3 vscode_bridge.py &
sleep 2
curl http://localhost:8080/health
# 以下のような応答が返るはずです: {"status": "healthy", ...}
kill %1  # バックグラウンドのブリッジサーバーを停止

⚡ クイックセットアップコマンド

# 1つのコマンドで完全なセットアップ (対話型)
python3 install.py

# 開発環境のクイックセットアップ
make setup-dev

# クイック検証
make dev-check

# 完全な品質パイプライン
make ci

# VS Codeブリッジサーバーをテスト (オプション)
python3 vscode_bridge.py --test-mode

🎯 インストールの要約

強化されたインストールプロセスにより、手動構成の必要性がなくなりました:

✅ 以前 (手動): ユーザーは設定ファイルを手動で編集し、パスを見つけ、環境変数を更新する必要がありました。
✅ 以降 (自動): 1つのコマンドですべてがすぐに使用できる状態になります。

主要な改善点:

• 🚀 手動構成不要: パスの更新や変数の編集が不要になりました。
• 🎛️ 対話型と非対話型: すべてのユーザーに対応する両方のモードで動作します。
• 🔧 プラットフォーム固有の構成: 各IDE/クライアントに最適化されたファイルを生成します。
• 📋 明確な手順: あなたのセットアップに対する正確な統合手順を提供します。
• ✨ スマートなデフォルト: 環境変数を賢く扱います。

🐳 Dockerデプロイメント (オプション)

コンテナ化されたデプロイメントのために、プロジェクトには包括的なDockerサポートが含まれています。

クイックDockerセットアップ

# 1. Docker構成を検証
python3 validate_docker.py

# 2. セットアップスクリプトでビルドして実行
./docker-setup.sh build
./docker-setup.sh start

# 3. または直接Docker Composeを使用
docker-compose up -d kotlin-mcp-server

Dockerの機能

• 🔒 セキュリティ: 非ルートユーザー、最小限の攻撃面
• 📦 最適化: マルチステージビルド、レイヤーキャッシュ
• 🔍 ヘルスチェック: 自動コンテナヘルス監視
• 🛠️ 開発: ライブ開発のためのボリュームマウント
• 🚀 本番環境: 本番デプロイのためのデーモンモード

利用可能なコマンド

./docker-setup.sh build              # イメージをビルド
./docker-setup.sh start              # 対話型開発
./docker-setup.sh daemon [path]      # 本番用デーモンモード
./docker-setup.sh logs               # コンテナログを表示
./docker-setup.sh shell              # コンテナシェルを開く
./docker-setup.sh test               # コンテナ内でテストを実行
./docker-setup.sh clean              # リソースをクリーンアップ

詳細なDockerセットアップ手順については、DOCKER_SETUP.mdを参照してください

---

🎯 実際のAndroidアプリを生成する

システムが完全な本番環境で使用可能なAndroidアプリを生成するのを見たいですか？ 以下の手順に従って、完全なE2Eワークフローを目撃してください。

🚀 最初のアプリを生成するクイックスタート

# 1. Kotlinサイドカーをビルド (fat JARを作成)
make sidecar

# 2. すべての機能を含む完全なAndroidアプリを生成
make e2e

# 3. あなたのAPKはここに表示されます:
ls -la e2e/sampleapp/app/build/outputs/apk/debug/app-debug.apk

あなたが得られるもの:

• ✅ 完全なGradleプロジェクト (Kotlin、Compose、Hilt、MVVM)
• ✅ ホーム画面 + 詳細画面を含む動作するAndroidアプリ
• ✅ エンティティとDAOを含むRoomデータベース
• ✅ APIサービスを含むRetrofitネットワーク層
• ✅ 合格するユニットテスト (Robolectric + JVMテスト)
• ✅ デバイス/エミュレーターにインストールできるAPK

🔧 利用可能なコマンド

# KotlinサイドカーJARをビルド
make sidecar

# 完全なAndroidアプリを生成
make e2e

# コードを整形して最適化
make fix

# detekt静的解析を実行
make detekt

# spotlessコード整形チェックを実行
make spotless

# すべてのアーティファクトをクリーンアップ
make clean

📊 生成されたアプリの機能

生成されたe2e/sampleappには以下が含まれます。

🏗️ アーキテクチャ:

• ViewModelを含むMVVMパターン
• Hilt依存性注入
• クリーンアーキテクチャの原則

🎨 UI/UX:

• Jetpack Compose画面
• Material3デザイン
• 画面間のナビゲーション

💾 データ層:

• エンティティを含むRoomデータベース
• リポジトリパターン
• マイグレーションスケルトン

🌐 ネットワーク:

• Retrofit APIクライアント
• OkHttpインターセプター
• エラーハンドリング

🧪 テスト:

• ViewModelのユニットテスト
• Robolectricを使用したDAOテスト
• APIサービステスト

📱 ビルド:

• デバッグAPKの生成
• Lint/整形チェック
• Gradleビルドの最適化

⚙️ 環境変数

# サイドカー構成
MCP_SIDECAR_CMD=["java", "-jar", "kotlin-sidecar/build/libs/kotlin-sidecar.jar"]

# パフォーマンスチューニング
MCP_API_TIMEOUT_MS=3000
MCP_RATE_LIMIT_QPS=10

# ビルド設定
ANDROID_SDK_ROOT=/path/to/android/sdk
JAVA_HOME=/path/to/jdk17

🔍 トラブルシューティング

Gradleビルドが失敗した場合:

# Android SDKがインストールされていることを確認し、ANDROID_SDK_ROOTが設定されていることを確認
export ANDROID_SDK_ROOT=/path/to/android/sdk

# クリーンアップして再ビルド
make clean && make e2e

サイドカーの接続に問題がある場合:

# JARがビルドされていることを確認
ls -la kotlin-sidecar/build/libs/kotlin-sidecar.jar

# サイドカーを直接テスト
java -jar kotlin-sidecar/build/libs/kotlin-sidecar.jar

APKが生成されない場合:

# ビルドログを確認
cd e2e/sampleapp && ./gradlew assembleDebug --info

# JDK 17が使用されていることを確認
java -version  # Java 17が表示されるはずです

📈 パフォーマンスベンチマーク

システムは以下のように最適化されています。

• サイドカーの起動: 2秒未満
• コード生成: コンポーネントごとに5秒未満
• ビルド時間: デバッグAPKの場合30秒未満
• テスト実行: ユニットテストの場合10秒未満

🎉 成功の指標

すべてが正常に動作した場合:

• ✅ kotlin-sidecar.jarが正常にビルドされます。
• ✅ e2e/sampleappディレクトリが完全なプロジェクトとともに作成されます。
• ✅ ./gradlew assembleDebugがエラーなく完了します。
• ✅ APKファイルが存在します: app/build/outputs/apk/debug/app-debug.apk
• ✅ ./gradlew testDebugUnitTestがテストに合格します。
• ✅ 生成されたコードにTODOプレースホルダーがありません。
• ✅ すべてのLint/整形チェックに合格します。

🎯 生成されたアプリは本番環境で使用可能で、すぐにAndroid Studioで開くことができます！

---

🏗️ V1.0からV2.0への移行

⚡ クイック移行手順

既存のV1.0インストールがある場合:

1. 現在のセットアップをバックアップ:

   # あなたの既存の設定をバックアップ
   cp mcp_config*.json ~/backup/
   

2. V2.0に更新:

   # 最新の変更を取得
   git pull origin main
   
   # V2.0インストーラーを実行
   python3 install.py 1
   

3. 移行を検証:

   # 新しいモジュールアーキテクチャをテスト
   python3 -c "from kotlin_mcp_server import KotlinMCPServer; print('✅ V2.0準備完了！')"
   

🔍 自動的に移行されるもの

• ✅ すべての30の元のツールが強化されたAI機能とともに保存されます。
• ✅ 設定ファイルが動的環境変数で更新されます。
• ✅ プロジェクトパスがクロスプラットフォーム形式に変換されます。
• ✅ 依存関係が最新バージョンに更新されます。
• ✅ セキュリティ設定が新しいコンプライアンス機能で強化されます。

⚠️ 移行に関する注意事項

• 下位互換性: V2.0はV1.0のプロジェクト構造との完全な互換性を維持します。
• 強化された出力: コード生成は現在、テンプレートではなく完全な実装を生成します。
• 新しい環境変数: オプションの新しい構成オプション (.env.exampleを参照)
• モジュール構造: 内部アーキテクチャが改善されています (ユーザーの操作は必要ありません)。

---

🏗️ プロジェクトルート解決ポリシー

概要

Kotlin MCPサーバーのすべてのツールは、ユーザーのプロジェクトワークスペースでのみ動作するようにリファクタリングされており、MCPサーバーの現在の作業ディレクトリでは動作しません。これにより、安全で予測可能なツールの動作が保証され、プロジェクト外の誤った変更が防止されます。

パス解決の優先順位

ツールは以下の順序でプロジェクトルートを解決します。

1. 明示的な入力: project_rootまたはprojectRootパラメーター
2. 環境変数: PROJECT_PATHまたはWORKSPACE_PATH
3. IDEメタデータ: MCPクライアント (VS Code、Cursorなど) からのワークスペースルート
4. フェイルセーフ: ツールはサーバーの現在の作業ディレクトリを使用する代わりにエラーを返します。

入力の同義語

ツールはキャメルケースとスネークケースの両方のパラメーター名を受け入れます。

// 両方の形式は同じように動作します
{
  "project_root": "/path/to/project",
  "file_path": "src/main.kt",
  "build_tool": "gradle",
  "skip_tests": false
}

{
  "projectRoot": "/path/to/project", 
  "filePath": "src/main.kt",
  "buildTool": "gradle",
  "skipTests": false
}

IDE統合のデフォルト

IDE拡張機能 (VS Code、Cursor) を使用する場合、ツールは自動的に以下を検出します。

• ワークスペースルート: アクティブなワークスペースディレクトリ
• アクティブなファイル: ファイルベースの操作のための現在開いているファイル
• 選択範囲: リファクタリング操作のためのテキスト選択範囲

セキュリティ保護

• パストラバーサル保護: すべてのファイルパスがプロジェクトルート以下であることが検証されます。
• サーバーの現在の作業ディレクトリ保護: 実行時チェックにより、誤ったサーバーディレクトリ操作が防止されます。
• 監査ロギング: すべてのツール操作がプロジェクトコンテキストとともにログに記録されます。

ツール呼び出しの例

明示的なプロジェクトルートを指定した場合:

{
  "tool": "buildAndTest",
  "input": {
    "project_root": "/Users/dev/MyAndroidApp",
    "buildTool": "gradle",
    "skipTests": false
  }
}

環境変数を使用した場合:

export PROJECT_PATH=/Users/dev/MyAndroidApp
# プロジェクトルートを指定しないツール呼び出しは環境変数を使用します

IDEの自動検出を使用した場合:

{
  "tool": "analyzeCodeQuality",
  "input": {
    "scope": "project",
    "ruleset": "all"
  }
}
// 自動的にアクティブなワークスペースを使用します

エラーハンドリング

ツールはプロジェクトルートが解決できない場合、明確なエラーを提供します。

{
  "success": false,
  "error": "ProjectRootRequired: pass `project_root` or set env PROJECT_PATH",
  "error_type": "ProjectRootRequired"
}

---

📚 包括的な使用ガイド

🛠 完全なツールリファレンス

Kotlin MCPサーバーは、Android開発のための31の包括的なツールを提供し、カテゴリ別に整理されています。

コア開発ツール

1. gradle_build - Androidプロジェクトのビルド

あなたのAndroidプロジェクトのGradleビルドタスクを実行します。

{
  "name": "gradle_build",
  "arguments": {
    "task": "assembleDebug",
    "clean_build": false,
    "parallel": true
  }
}

パラメーター:

• task (文字列): 実行するGradleタスク (例: "assembleDebug", "build", "test")
• clean_build (ブール値, オプション): ビルド前にクリーンアップするかどうか
• parallel (ブール値, オプション): 並列実行を有効にするかどうか

使用例:

# デバッグAPKをビルド
{"name": "gradle_build", "arguments": {"task": "assembleDebug"}}

# クリーンアップしてリリース版をビルド
{"name": "gradle_build", "arguments": {"task": "assembleRelease", "clean_build": true}}

# すべてのテストを実行
{"name": "gradle_build", "arguments": {"task": "test"}}

2. run_tests - テストスイートの実行

ユニットテスト、統合テスト、またはUIテストを包括的なレポート付きで実行します。

{
  "name": "run_tests",
  "arguments": {
    "test_type": "unit",
    "test_class": "UserRepositoryTest",
    "generate_report": true
  }
}

パラメーター:

• test_type (文字列): "unit", "integration", "ui", または "all"
• test_class (文字列, オプション): 実行する特定のテストクラス
• generate_report (ブール値, オプション): HTMLテストレポートを生成するかどうか

3. create_kotlin_file - Kotlinファイルの生成

適切なパッケージ宣言とインポートを含む構造化されたKotlinファイルを作成します。

{
  "name": "create_kotlin_file",
  "arguments": {
    "file_path": "src/main/kotlin/com/example/User.kt",
    "class_name": "User",
    "class_type": "data_class",
    "properties": ["id: String", "name: String", "email: String"],
    "package_name": "com.example.model"
  }
}

パラメーター:

• file_path (文字列): 新しいファイルの相対パス
• class_name (文字列): メインクラスの名前
• class_type (文字列): "class", "data_class", "sealed_class", "object", "interface"
• properties (配列, オプション): データクラスのプロパティのリスト
• package_name (文字列, オプション): パッケージ宣言

4. create_layout_file - XMLレイアウトの生成

適切な構造を持つAndroid XMLレイアウトファイルを作成します。

{
  "name": "create_layout_file",
  "arguments": {
    "file_path": "src/main/res/layout/activity_main.xml",
    "layout_type": "activity",
    "root_element": "LinearLayout",
    "include_common_attributes": true
  }
}

5. analyze_project - プロジェクト分析

あなたのAndroidプロジェクトの構造、依存関係、およびアーキテクチャの包括的な分析を提供します。

{
  "name": "analyze_project",
  "arguments": {
    "analysis_type": "architecture",
    "include_dependencies": true,
    "check_best_practices": true
  }
}

分析タイプ:

• architecture: 全体的なプロジェクト構造とパターン
• dependencies: Gradle依存関係とバージョン
• security: セキュリティ脆弱性とベストプラクティス
• performance: パフォーマンスのボトルネックと最適化

6. format_code - コード整形

スタイルガイドに従ってKotlinコードを整形します。

{
  "name": "format_code",
  "arguments": {
    "file_path": "src/main/kotlin/MainActivity.kt",
    "style_guide": "ktlint"
  }
}

7. run_lint - 静的コード分析

コードの問題を検出するためにlint分析を実行します。

{
  "name": "run_lint",
  "arguments": {
    "lint_tool": "detekt",
    "fail_on_warnings": false,
    "generate_report": true
  }
}

8. generate_docs - ドキュメント生成

さまざまな形式でプロジェクトのドキュメントを生成します。

{
  "name": "generate_docs",
  "arguments": {
    "doc_type": "kdoc",
    "output_format": "html",
    "include_private": false
  }
}

UI開発ツール

9. create_compose_component - Jetpack Composeコンポーネント

ベストプラクティスに基づいてJetpack Compose UIコンポーネントを生成します。

{
  "name": "create_compose_component",
  "arguments": {
    "component_name": "UserCard",
    "component_type": "composable",
    "file_path": "src/main/kotlin/ui/components/UserCard.kt",
    "parameters": [
      "user: User",
      "onClick: () -> Unit"
    ],
    "include_preview": true,
    "material_design": "material3"
  }
}

コンポーネントタイプ:

• composable: 標準的なコンポーザブル関数
• stateful: 内部状態を持つコンポーザブル
• stateless: 純粋なUIコンポーザブル
• layout: 子要素を持つレイアウトコンポーザブル

10. create_custom_view - カスタムAndroidビュー

適切なライフサイクル管理を持つカスタムビュークラスを作成します。

{
  "name": "create_custom_view",
  "arguments": {
    "view_name": "CircularProgressView",
    "base_class": "View",
    "file_path": "src/main/kotlin/ui/views/CircularProgressView.kt",
    "custom_attributes": [
      {"name": "progressColor", "type": "color"},
      {"name": "strokeWidth", "type": "dimension"}
    ]
  }
}

アーキテクチャとパターンツール

11. setup_mvvm_architecture - MVVMの実装

ViewModel、リポジトリ、およびUI層を含む完全なMVVMアーキテクチャをセットアップします。

{
  "name": "setup_mvvm_architecture",
  "arguments": {
    "feature_name": "UserProfile",
    "package_name": "com.example.userprofile",
    "include_repository": true,
    "include_use_cases": true,
    "state_management": "compose"
  }
}

生成されるファイル:

• 状態管理を含むViewModel
• データソース抽象化を含むリポジトリ
• ビジネスロジックのためのユースケース
• UIコンポーザブルまたはフラグメント
• イベントのための状態クラスと密封クラス

12. setup_dependency_injection - DIフレームワークのセットアップ

HiltまたはDaggerを使用して依存性注入を構成します。

{
  "name": "setup_dependency_injection",
  "arguments": {
    "di_framework": "hilt",
    "modules": ["DatabaseModule", "NetworkModule", "RepositoryModule"],
    "application_class": "MyApplication"
  }
}

13. setup_room_database - データベースのセットアップ

エンティティ、DAO、およびマイグレーションを含むRoomデータベースの実装を作成します。

{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "entities": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "String", "primaryKey": true},
          {"name": "name", "type": "String"},
          {"name": "email", "type": "String"}
        ]
      }
    ],
    "version": 1,
    "enable_encryption": true
  }
}

14. setup_retrofit_api - ネットワーク層

適切なエラーハンドリングとインターセプターを持つRetrofit APIインターフェースをセットアップします。

{
  "name": "setup_retrofit_api",
  "arguments": {
    "base_url": "https://api.example.com/",
    "endpoints": [
      {
        "name": "getUser",
        "method": "GET",
        "path": "users/{id}",
        "response_type": "User"
      }
    ],
    "include_interceptors": ["logging", "auth", "retry"],
    "enable_cache": true
  }
}

セキュリティとコンプライアンスツール

15. encrypt_sensitive_data - データ暗号化

業界標準の暗号化を使用して敏感なデータを暗号化します。

{
  "name": "encrypt_sensitive_data",
  "arguments": {
    "data": "Patient: John Doe, SSN: 123-45-6789",
    "data_type": "phi",
    "compliance_level": "hipaa",
    "encryption_algorithm": "AES-256"
  }
}

16. implement_gdpr_compliance - GDPRの実装

完全なGDPRコンプライアンスフレームワークを実装します。

{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": [
      "consent_management",
      "data_portability",
      "right_to_erasure",
      "privacy_policy",
      "data_breach_notification"
    ],
    "supported_languages": ["en", "de", "fr"],
    "include_ui": true
  }
}

生成されるコンポーネント:

• 同意管理UIとロジック
• データエクスポート機能
• ユーザーデータ削除ワークフロー
• プライバシーポリシーテンプレート
• 監査ロギングシステム

17. implement_hipaa_compliance - HIPAAの実装

HIPAAコンプライアンスのセキュリティ対策を実装します。

{
  "name": "implement_hipaa_compliance",
  "arguments": {
    "package_name": "com.healthcare.app",
    "features": [
      "audit_logging",
      "access_controls",
      "encryption",
      "secure_messaging",
      "risk_assessment"
    ],
    "minimum_password_strength": "high",
    "session_timeout": 900
  }
}

18. setup_secure_storage - セキュアデータストレージ

敏感なデータのための暗号化されたストレージを構成します。

{
  "name": "setup_secure_storage",
  "arguments": {
    "storage_type": "room_encrypted",
    "package_name": "com.example.app",
    "data_classification": "restricted",
    "key_management": "android_keystore"
  }
}

AI/ML統合ツール

19. query_llm - 言語モデルのクエリ

コード支援のためにローカルまたはリモートの言語モデルにクエリを送信します。

{
  "name": "query_llm",
  "arguments": {
    "prompt": "Generate a Kotlin data class for User with validation",
    "llm_provider": "local",
    "model": "codellama",
    "privacy_mode": true,
    "max_tokens": 1000,
    "temperature": 0.2
  }
}

サポートされるプロバイダー:

• local: Ollama, LocalAI
• openai: GPT-4, GPT-3.5
• anthropic: Claudeモデル
• custom: カスタムAPIエンドポイント

20. analyze_code_with_ai - AIによるコード分析

AIを使用してコードのさまざまな側面を分析します。

{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/kotlin/UserManager.kt",
    "analysis_type": "security",
    "use_local_model": true,
    "detailed_report": true
  }
}

分析タイプ:

• security: セキュリティ脆弱性とベストプラクティス
• performance: パフォーマンス最適化の提案
• bugs: 潜在的なバグの検出
• style: コードスタイルの改善
• complexity: コードの複雑性分析
• maintainability: 保守性の評価

21. generate_code_with_ai - AIによるコード生成

自然言語の説明に基づいてAIを使用してコードを生成します。

{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "Login screen with biometric authentication and error handling",
    "code_type": "compose_screen",
    "framework": "compose",
    "compliance_requirements": ["gdpr"],
    "include_tests": true,
    "style_guide": "material3"
  }
}

ファイル管理ツール

22. manage_project_files - 高度なファイル操作

包括的なファイル管理操作を実行します。

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "backup",
    "include_build_files": false,
    "compression": "zip",
    "encryption": true,