Droid MCP Rs

🚀 droid-mcp-rs

高性能 Rust MCP サーバーで、Factory.ai Droid CLI をラップして AI 支援型のプログラミング機能を提供します。

🚀 クイックスタート

# 1. リポジトリをクローンする
git clone https://github.com/zcg/droid-mcp-rs.git
cd droid-mcp-rs

# 2. Release バージョンをビルドする
cargo build --release

# 3. Claude Code を設定する
claude mcp add droid-rs -s user --transport stdio -- ./target/release/droid-mcp-rs

# 4. Claude Code MCP サービスを再起動する
claude mcp restart

# 5. 使用を開始する！

これで、Claude Code で直接 droid ツールを使用できます！🎉

✨ 主な機能

✅ コア機能

1. MCP プロトコルサポート - Claude Code やその他の MCP クライアントとシームレスに統合します。
2. 完全な Droid 統合 - すべての droid exec コマンドライン引数をサポートします。
3. 自律性レベル制御 - 細かい権限管理ができます（DEFAULT/low/medium/high）。
4. セッション管理 - 複数回の対話とセッションの復元が可能です（SESSION_ID）。
5. DROID.md サポート - プロジェクト固有のコンテキストが自動的に注入されます。
6. カスタムモデルシステム - ~/.factory/config.json 設定を自動的に読み込みます。
7. セキュリティを重視 - デフォルトで読み取り専用で、明示的に権限を指定する必要があります。
8. リソース制限 - 自動的なタイムアウトとサイズ制限があります。
9. クロスプラットフォーム - Windows、Linux、macOS のすべてのプラットフォームをサポートします。

✅ 高度な機能

1. 推論モード (reasoning_effort) - low/medium/high の 3 段階の推論深度があります。
2. 規範モード (use_spec + spec_model) - まず計画を立ててから実行します。
3. 権限スキップ (skip_permissions_unsafe) - 隔離環境で制限なしで実行します（危険！）。
4. 出力形式 (output_format) - stream-json（デフォルト）または stream-jsonrpc が選択できます。
5. ファイル入力 (file) - ファイルからタスクのプロンプトを読み取ります。
6. ツール制御 (enabled_tools / disabled_tools) - 使用可能なツールを細かく制御できます。

📦 インストール

ソースコードからビルドする

git clone https://github.com/zcg/droid-mcp-rs.git
cd droid-mcp-rs
cargo build --release

バイナリファイルの場所：

• Linux/macOS: target/release/droid-mcp-rs
• Windows: target/release/droid-mcp-rs.exe

Claude Code を設定する

claude mcp add droid-rs -s user --transport stdio -- /path/to/droid-mcp-rs

Claude Desktop を設定する

settings.json を編集します：

{
  "mcpServers": {
    "droid": {
      "command": "/path/to/droid-mcp-rs"
    }
  }
}

🎨 完全なパラメータリスト

排他的なパラメータ：

• PROMPT と file は同時に指定できません。
• skip_permissions_unsafe と auto は同時に指定できません。

🔐 自律性レベル

⚠️ 重要提示

デフォルトで auto=high です。設定ファイルで allow_high_autonomy=false を設定することで無効にできます。

💻 使用例

シナリオ 1️⃣：基本的なクエリ（すべてのデフォルト値を使用）

await use_mcp_tool("droid", {
  PROMPT: "分析这个项目的代码质量"
});
// 自動的に使用される: auto=high, 最初の GPT モデル, stream-json

シナリオ 2️⃣：深度推論 + 規範モード

await use_mcp_tool("droid", {
  PROMPT: "重构认证模块，提升安全性",
  reasoning_effort: "high",  // 深度推論
  use_spec: true,            // まず計画を立ててから実行
  spec_model: "gpt-5.1"      // GPT-5.1 を使用して計画
});

シナリオ 3️⃣：複数回のセッション

// 最初のラウンド: タスクを開始する
const result1 = await use_mcp_tool("droid", {
  PROMPT: "创建用户认证功能"
});

// 2 回目のラウンド: セッションを続ける
const result2 = await use_mcp_tool("droid", {
  PROMPT: "添加单元测试",
  SESSION_ID: result1.SESSION_ID  // コンテキストを復元する
});

// 3 回目のラウンド: さらに改善する
const result3 = await use_mcp_tool("droid", {
  PROMPT: "优化性能",
  SESSION_ID: result2.SESSION_ID
});

シナリオ 4️⃣：ファイルからタスクを読み取る

// prompt.md の内容:
// # タスク
// 重构整个项目架构...

await use_mcp_tool("droid", {
  file: "./prompt.md",      // ファイルから読み取る
  reasoning_effort: "high"
});

シナリオ 5️⃣：カスタムモデル

await use_mcp_tool("droid", {
  PROMPT: "生成 API 文档",
  model: "custom:Sonnet-4.5-[88code]-0"  // カスタムモデルを使用する
});

シナリオ 6️⃣：隔離環境で制限なしで実行する

// ⚠️ Docker コンテナなどの隔離環境でのみ使用してください！
await use_mcp_tool("droid", {
  PROMPT: "系统级配置修改",
  skip_permissions_unsafe: true  // すべての権限チェックをスキップする
});

シナリオ 7️⃣：ツールを細かく制御する

await use_mcp_tool("droid", {
  PROMPT: "分析代码但不要修改",
  enabled_tools: "read,grep,find",   // 読み取り系のツールのみ許可する
  disabled_tools: "write,edit,bash"  // 書き込み系のツールを無効にする
});

⚙️ 設定システム

設定ファイル：droid-mcp.config.json

作業ディレクトリに作成する（または DROID_MCP_CONFIG_PATH 環境変数で指定する）：

{
  "additional_args": [],
  "timeout_secs": 600,
  "max_timeout_secs": 3600,
  "default_auto": "high",
  "default_model": "claude-opus-4-5-20251101",
  "allow_high_autonomy": true
}

フィールドの説明：

環境変数

🎭 カスタムモデルシステム

設定ファイルの場所

• Linux/macOS: ~/.factory/config.json
• Windows: C:\Users\<user>\.factory\config.json

設定形式

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 1M [88code]",
      "model": "claude-sonnet-4-5-20250929-thinking[1m]",
      "base_url": "https://www.88code.org/droid",
      "api_key": "your-api-key",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5.1-Codex [88code]",
      "model": "gpt-5.1-codex",
      "base_url": "https://www.88code.org/droid/v1",
      "api_key": "your-api-key",
      "provider": "openai"
    }
  ]
}

カスタムモデルの使用

モデルの参照形式：custom:Display-Name-Index

// 最初のモデル（インデックス 0）
await use_mcp_tool("droid", {
  PROMPT: "代码分析",
  model: "custom:Sonnet-4.5-1M-[88code]-0"
});

// 2 番目のモデル（インデックス 1）
await use_mcp_tool("droid", {
  PROMPT: "生成文档",
  model: "custom:GPT-5.1-Codex-[88code]-1"
});

特徴：

• ✅ MCP ツールの説明にすべての利用可能なモデルを自動的に表示します。
• ✅ 実行前に使用するモデルをログに表示します。
• ✅ 結果にモデル情報（model_info フィールド）を返します。
• ✅ タスクごとに異なるモデルを切り替えて最適な結果を得ることができます。
• ✅ デフォルトでは GPT モデルを優先的に選択します（スマートなモデル選択）。

ログの例：

droid-mcp-rs: Sonnet 4.5 1M [88code] [anthropic] (claude-sonnet-4-5-20250929-thinking[1m])

📝 DROID.md システムプロンプト

作業ディレクトリに DROID.md ファイルを配置すると、プロジェクト固有のコンテキストを定義できます：

# プロジェクトコンテキスト

これは React と Next.js を使用した TypeScript プロジェクトです。

## 開発ガイド
- 関数型コンポーネントと Hooks を使用する
- 既存のファイル構造に従う
- 新機能に対してテストを書く
- TypeScript の厳格モードを使用する

特徴：

• 内容は自動的に <system_prompt>...</system_prompt> として各プロンプトの前に注入されます。
• 最大サイズ：1 MB
• 制限を超えると自動的に切り捨てられます（UTF-8 文字境界で安全）。

🔒 セキュリティ機能

• ✅ デフォルトで読み取り専用 - auto パラメータがない場合、読み取り操作のみが許可されます。
• ✅ 明示的な権限 - auto レベルを明示的に指定しないと変更できません。
• ✅ タイムアウト強制 - 無限実行を防止します（デフォルトで 10 分）。
• ✅ 高権限保護 - high レベルは設定ファイルで許可する必要があります。
• ✅ リソース制限 - 自動的なサイズとメモリ制限があります。
  • Agent メッセージ：10 MB
  • すべてのメッセージ：50 MB
  • DROID.md：1 MB
  • stderr：100 KB

🛠️ 開発ガイド

ビルドコマンド

cargo build              # デバッグビルド
cargo build --release    # 最適化ビルド（LTO を有効にする）
cargo clean              # ビルド生成物をクリーンアップする

テストとコード品質

cargo test               # テストを実行する
cargo clippy             # コードチェック
cargo fmt                # コードをフォーマットする
cargo check              # 高速な型チェック

開発要件

• Rust 1.70+
• Droid CLI がインストールされ、PATH に含まれていること

🏗️ アーキテクチャの概要

データフロー

Claude Code (MCP Client)
    ↓ stdio transport
MCP Server (main.rs)
    ↓ clap CLI parsing
Tool Handler (server.rs::droid)
    ↓ parameter validation + MCP protocol
CLI Wrapper (droid.rs::run)
    ↓ async process spawn + JSON stream parsing
droid exec CLI (subprocess)

コアファイル

重要な設計パターン

1. 遅延設定読み込み - OnceLock を使用して静的設定をキャッシュします。
2. ストリーミング処理 - 非同期で JSON ストリームを 1 行ずつ解析します。
3. サイズ制限 - 複数レベルの切り捨て境界（10MB/50MB/1MB）があります。
4. タイムアウトラッパー - tokio::time::timeout を使用してタイムアウトを強制します。
5. カスタムモデルシステム - スマートな GPT 優先 + インデックス参照。

📁 設定ファイルの位置のまとめ

🎉 機能の完全性チェック

✓ コア機能

• [x] MCP プロトコルの完全なサポート
• [x] すべての droid exec パラメータのマッピング
• [x] セッション管理（SESSION_ID）
• [x] カスタムモデルシステム
• [x] DROID.md の注入
• [x] スマートなモデル選択（GPT 優先）

✓ 高度な機能

• [x] 推論モード（reasoning_effort）
• [x] 規範モード（use_spec）
• [x] 権限スキップ（skip_permissions_unsafe）
• [x] 出力形式制御（output_format）
• [x] ファイル入力（file）
• [x] ツール制御（enabled_tools/disabled_tools）

✓ 品質保証

• [x] 警告なしでコンパイル
• [x] Clippy をすべて通過
• [x] クロスプラットフォームサポート（Windows/Linux/macOS）
• [x] 完全なエラー処理
• [x] リソース制限とセキュリティ制御

📄 ライセンス

MIT License - 詳細は LICENSE を参照してください。

🔗 関連プロジェクト

• codex-mcp-rs - Codex CLI MCP wrapper
• gemini-mcp-rs - Gemini CLI MCP wrapper
• Factory.ai Droid - 公式の Droid CLI ツール

💬 サポートとフィードバック

• 問題フィードバック: GitHub Issues
• MCP ドキュメント: modelcontextprotocol.io
• Droid ドキュメント: docs.factory.ai