Development Environment MCP Server

ミッション： この MCP サーバーは、AI エージェントやツールに、コンテキストを踏まえた豊富な環境情報を自動的に提供することで、ユーザーがプロンプトをシームレスに利用できるようにします。

---

✨ 特長

• 🔍 環境の自動検出 - Windows、Linux、macOS
• 🐚 シェルに対応したコマンド - PowerShell、Bash、Zsh の構文を最適化
• 🤖 VS Code Insiders の MCP 統合 - GitHub Copilot とシームレスに統合
• 🌐 クロスプラットフォーム対応 - 開発環境を問わず動作
• 📦 複数のインストール方法 - NPM、PyPI、Docker Hub
• 🔧 拡張可能 - 簡単にカスタマイズ、拡張できます
• 🖥️ アーキテクチャ対応 - システムアーキテクチャを常に検出して報告
• 🚀 本番環境対応 - 包括的なテストカバレッジと自動化された CI/CD

🚀 クイックスタート

NPM（推奨）

# Install globally
npm install -g dev-env-copilot

# Or use without installing
npx dev-env-copilot

Python/PyPI

# Install from PyPI
pip install dev-env-copilot

# Run the server
python -m dev_environment_mcp.server

Docker（最も簡単）

# Run from Docker Hub (no installation needed)
docker run -i 0nilinkz/dev-env-copilot

# Or from GitHub Container Registry
docker run -i ghcr.io/yourusername/dev-env-copilot

# Test with a simple MCP request
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | docker run -i 0nilinkz/dev-env-copilot

🔧 VS Code Insiders との統合

MCP サーバーのセットアップ（推奨）

VS Code Insiders の MCP 設定ファイルに追加します。

Windows: %APPDATA%\Code - Insiders\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json macOS: ~/Library/Application Support/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json Linux: ~/.config/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "dev-environment": {
      "command": "npx",
      "args": ["dev-env-copilot"]
    }
  }
}

詳しいセットアップ手順については、VSCODE_INSIDERS_MCP_SETUP.md をご覧ください。

その他の統合方法

方法 1：Docker との統合

{
  "mcpServers": {
    "dev-env-copilot-docker": {
      "command": "docker",
      "args": [
        "run", "--rm", "--interactive",
        "0nilinkz/dev-env-copilot"
      ]
    }
  }
}

方法 2：Python のインストール

{
  "mcpServers": {
    "dev-env-copilot-python": {
      "command": "python",
      "args": ["-m", "dev_environment_mcp.server"]
    }
  }
}

Copilot を使った使用例

User: "Run the tests"
Copilot: (detects Windows PowerShell) "python -m pytest test/"

User: "Run the tests" 
Copilot: (detects Linux) "python3 -m pytest test/"

User: "Set environment variable"
Copilot: (Windows) "$env:PYTHONPATH = 'c:\dev\project'"
Copilot: (Linux) "export PYTHONPATH=/home/user/project"

📊 本番環境対応

自動化された CI/CD パイプライン

• ✅ マルチプラットフォームテスト - Ubuntu、Windows、macOS
• ✅ 複数バージョンへの対応 - Python 3.8-3.12
• ✅ 自動公開 - NPM、PyPI、Docker Hub
• ✅ 段階的なデプロイ - デプロイ前にテストの合格が必須
• ✅ 独立したデプロイ - 各レジストリに個別にデプロイ

包括的なテストカバレッジ

# All installation methods verified
✅ Python/PyPI     - Native execution
✅ NPM/Node.js     - Cross-platform wrapper
✅ Docker          - Multi-architecture builds
✅ MCP Protocol    - Full protocol compliance

デプロイアーキテクチャの詳細については、DEPLOYMENT_SETUP.md をご覧ください。

利用可能なツール

MCP サーバーは次のツールを公開します。

detect_environment

現在の OS、シェル、ハードウェアを検出し、環境のコンテキストを提供します。

パラメーター：

• format（string）：出力形式 - "json"、"summary"、"copilot"

get_command_syntax

現在の環境に適したコマンド構文を提供します。

パラメーター：

• operation（string）：操作の種類 - "test"、"build"、"deploy"、"install"
• target（string、optional）：対象環境 - "local"、"remote"、"pi"
• format（string）：出力形式 - "shell"、"explanation"、"examples"

format_command

汎用コマンドを現在の環境に合わせて整形します。

パラメーター：

• command_template（string）：プレースホルダーを含むコマンドテンプレート
• variables（object）：テンプレート内で置換する変数

get_project_context

現在のプロジェクト構造を分析し、関連するコンテキストを提供します。

パラメーター:

• include_files (boolean): 出力にファイル一覧を含めるかどうか
• analyze_dependencies (boolean): package.json/requirements.txt を分析するかどうか

設定

環境変数

• DEV_ENV_MCP_CONFIG: カスタム設定ファイルのパス
• DEV_ENV_MCP_LOG_LEVEL: ログレベル（DEBUG、INFO、WARN、ERROR）
• DEV_ENV_MCP_CACHE_TTL: 環境検出のキャッシュ TTL（秒）

カスタム設定

dev-env-mcp.json 設定ファイルを作成します。

{
  "detection": {
    "cache_ttl": 300,
    "enable_hardware_detection": true,
    "custom_environments": {
      "my-docker": {
        "detect_command": "cat /.dockerenv",
        "shell": "bash",
        "python_cmd": "python3"
      }
    }
  },
  "commands": {
    "custom_operations": {
      "my-build": {
        "windows": "msbuild /p:Configuration=Release",
        "linux": "make build",
        "macos": "xcodebuild -configuration Release"
      }
    }
  }
}

💻 コマンドラインでの使用方法

単独コマンド

# Environment detection
npx dev-env-copilot detect-environment --format json

# Command syntax help
npx dev-env-copilot get-command-syntax --operation test --target local
npx dev-env-copilot get-command-syntax --operation deploy --target pi --format explanation

# MCP server modes
npx dev-env-copilot --mcp-mode --transport stdio
npx dev-env-copilot --mcp-mode --transport http --host 0.0.0.0 --port 9000

詳細設定

環境変数

• DEV_ENV_MCP_LOG_LEVEL: ログレベルを設定します（DEBUG、INFO、WARN、ERROR）
• DEV_ENV_MCP_CACHE_TTL: 環境検出のキャッシュ期間を設定します（秒）
• DEV_ENV_MCP_CONFIG: カスタム設定ファイルのパス

カスタム設定ファイル

~/.config/dev-env-mcp/config.json を作成します。

{
  "detection": {
    "cache_ttl": 300,
    "enable_hardware_detection": true,
    "custom_project_roots": [
      "/custom/dev/path",
      "c:\\custom\\dev\\path"
    ]
  },
  "commands": {
    "custom_operations": {
      "my-test": {
        "windows": "npm test",
        "linux": "npm test",
        "pi": "sudo npm test"
      }
    }
  },
  "logging": {
    "level": "INFO",
    "file": "~/.local/logs/dev-env-mcp.log"
  }
}

🔥 統合例

GitHub Copilot Chat

このサーバーは環境認識機能によって GitHub Copilot を強化します。

👤 User: "How do I run tests in this project?"
🤖 Copilot: Based on your Windows PowerShell environment and package.json, run:
         npm test
         
👤 User: "Set up a Python virtual environment"  
🤖 Copilot: For Windows PowerShell:
         python -m venv venv
         .\venv\Scripts\Activate.ps1

ターミナルコマンドの生成

👤 User: "Install dependencies and start dev server"
🤖 Copilot: (detects Node.js project on Windows)
         npm install && npm run dev
         
👤 User: "Same command but for production"
🤖 Copilot: npm ci && npm run build && npm start

🛠 API リファレンス

MCP ツール

detect_environment

包括的な環境情報を返します。

レスポンス:

{
  "os": "windows",
  "shell": "powershell", 
  "architecture": "x64",
  "python_version": "3.11.0",
  "node_version": "18.17.0",
  "hardware": "desktop"
}

get_command_syntax

パラメーター:

• operation: "test" | "build" | "deploy" | "install" | "run"
• target: "local" | "remote" | "pi" | "docker"
• format: "shell" | "explanation" | "examples"

format_command

パラメーター:

• command_template: {variables} を含むテンプレート
• variables: 置換値を含むオブジェクト

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

よくある問題

「コマンドが見つかりません」というエラー

# Check NPM installation
npm list -g dev-env-copilot

# Reinstall if needed
npm install -g dev-env-copilot

# Check Python installation
pip show dev-env-copilot

VS Code Insiders の MCP 統合が動作しない

1. MCP 設定ファイルの場所と形式を確認します
2. 設定を変更した後、VS Code Insiders を再起動します
3. VS Code の開発者コンソールでエラーを確認します（Help > Toggle Developer Tools）
4. VS Code Insiders（通常の VS Code ではありません）を使用していることを確認します

Docker の権限に関する問題

# Linux/macOS - add user to docker group
sudo usermod -aG docker $USER
newgrp docker

# Windows - ensure Docker Desktop is running

MCP プロトコルに関する問題

# Test MCP server directly
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | npx dev-env-copilot

# Test Python server
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | python -m dev_environment_mcp.server

デバッグモード

詳細なログを有効にします。

# Set environment variable
export DEV_ENV_MCP_LOG_LEVEL=DEBUG

# Or create config file with debug logging
echo '{"logging": {"level": "DEBUG"}}' > ~/.config/dev-env-mcp/config.json

📚 追加ドキュメント

• VS Code Insiders MCP のセットアップ - 統合の完全ガイド
• デプロイのセットアップ - CI/CD パイプラインとワークフローのアーキテクチャ
• Docker のセットアップ - コンテナーのデプロイガイド
• Docker と VS Code の統合 - コンテナー化の詳細設定
• 統合ガイド - 技術的な統合の詳細
• 配布の概要 - デプロイと公開の概要

🏗️ 開発と貢献

開発環境のクイックセットアップ

git clone https://github.com/yourusername/dev-env-copilot.git
cd dev-env-copilot

# Install dependencies
npm install
pip install -e .

# Run tests
python tests/test_mcp_proper.py
node bin/dev-env-copilot.js < echo '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{}}'

ワークフローの構造

CI/CD では、最新のステージベースのアーキテクチャを採用した GitHub Actions を使用しています。

Test Stage (test-and-build.yml)
├── Multi-platform testing (Ubuntu, Windows, macOS)
├── Multi-version testing (Python 3.8-3.12)
└── MCP protocol compliance verification

Deploy Stage (on release)
├── deploy-pypi.yml    → PyPI publishing
├── deploy-npm.yml     → npm registry  
└── docker-deploy.yml  → Docker Hub + GHCR

主な特徴:

• 🔒 信頼性: テストに合格しなければデプロイされません
• 🔧 モジュール性: 各デプロイ形式は独立しています
• ⚡ 効率性: 再利用可能なワークフローで重複がありません
• 🎯 柔軟性: 特定のレジストリに個別にデプロイできます

貢献

皆さまからの貢献を歓迎します。このプロジェクトは、以下のように構成されています。

• ✅ 包括的なテストカバレッジ
• ✅ 自動化された品質チェック
• ✅ 明確なドキュメント
• ✅ 最新の開発ワークフロー

まずは issue または pull request を作成してください。

📄 ライセンス

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

🙏 謝辞

• Anthropic による Model Context Protocol（MCP）
• MCP 統合を提供してくださった GitHub Copilot チーム
• クロスプラットフォーム開発コミュニティ

---

ご質問はありますか？ issue を作成するか、ディスカッションを始めてください！