Devenvmcp

🚀 Dev-Env Sentinel MCP

Dev-Env Sentinel MCP 是一個輕量級、高效的 MCP 服務器，用於監控和驗證開發環境的健康狀況。它能幫助開發者及時發現並解決開發環境中存在的問題，確保開發工作的順利進行。

✨ 主要特性

• 語言無關性：核心引擎可通過 YAML 配置文件與任何語言或工具協同工作。
• 配置驅動：所有特定工具的邏輯都存儲在 YAML 文件中。
• 遵循 DRY/KISS 原則：使用共享工具，最大程度減少代碼重複。
• 高效性：針對性能進行優化，內存佔用低。

📦 安裝指南

通過 npm/npx（推薦）

全局安裝：

npm install -g dev-env-sentinel

或者使用 npx（無需安裝）：

npx dev-env-sentinel

針對 MCP 客戶端

Cursor

將以下內容添加到 Cursor MCP 設置中（Linux/Mac 系統路徑為 ~/.cursor/mcp.json，Windows 系統路徑為 %APPDATA%\Cursor\mcp.json）：

{
  "mcpServers": {
    "dev-env-sentinel": {
      "command": "npx",
      "args": ["-y", "dev-env-sentinel"]
    }
  }
}

如果是全局安裝，可以這樣配置：

{
  "mcpServers": {
    "dev-env-sentinel": {
      "command": "dev-env-sentinel"
    }
  }
}

Claude Code

將以下內容添加到 Claude Code MCP 配置中：

{
  "mcpServers": {
    "dev-env-sentinel": {
      "command": "npx",
      "args": ["-y", "dev-env-sentinel"]
    }
  }
}

Google Antigravity

將以下內容添加到 Antigravity MCP 配置中：

{
  "mcpServers": {
    "dev-env-sentinel": {
      "command": "npx",
      "args": ["-y", "dev-env-sentinel"]
    }
  }
}

📚 詳細文檔

項目結構

dev-env-sentinel/
├── cmd/
│   └── sentinel/          # MCP 服務器入口點
├── internal/
│   ├── common/            # 共享工具（遵循 DRY 原則）
│   ├── config/            # 配置加載
│   ├── detector/          # 生態系統檢測
│   ├── verifier/          # 構建新鮮度驗證
│   ├── auditor/           # 依賴項/環境變量審計
│   └── reconciler/        # 自動修復功能
├── config/                # 配置文件
│   ├── languages/         # 語言級配置
│   │   └── *.yaml        # 語言配置（如 java.yaml、python.yaml 等）
│   ├── tools/             # 特定語言工具配置
│   │   ├── java/         # Java 工具（Maven、Gradle、Spring 等）
│   │   ├── python/       # Python 工具（Poetry、Conda）
│   │   ├── javascript/   # JavaScript 工具（npm、React、Vite 等）
│   │   └── csharp/       # C# 工具（MSBuild、NuGet、dotnet CLI）
│   └── infrastructure/    # 基礎設施工具
│       ├── docker/        # Docker 工具
│       ├── containers/    # 容器相關工具
│       └── databases/    # 數據庫工具
│           └── postgres/ # PostgreSQL 工具
└── docs/                  # 文檔

核心原則

1. DRY（不要重複自己）：在 internal/common 中使用共享工具。
2. KISS（保持簡單）：功能聚焦，職責明確。
3. 高效性：最小化內存分配，優化文件操作。
4. 可擴展性：通過 YAML 配置文件添加新的生態系統。

開發

前提條件

• Go 1.13 及以上版本（支持 Go Modules）
• Node.js 14 及以上版本（用於構建腳本）
• config/ 目錄結構下的 YAML 配置文件

構建

為當前平臺構建：

npm run build

為所有平臺（Windows 和 Linux）構建：

npm run build:all

為特定平臺構建：

npm run build:windows
npm run build:linux

或者直接使用 Go 進行構建：

go build ./cmd/sentinel

運行

運行 MCP 服務器（MCP 模式無需參數）：

./sentinel

或者通過 npm 運行：

npx dev-env-sentinel

支持的生態系統

第一階段（MVP）

• Java：Maven (pom.xml)、Gradle (build.gradle)
• npm：npm、Yarn、pnpm (package.json)

第二階段（已實現）

• React：React 應用程序 (package.json 包含 React)
• Vite：Vite 構建工具 (vite.config.js/ts)
• Python：pip (requirements.txt, setup.py)
• Poetry：Poetry 包管理器 (pyproject.toml, poetry.lock)
• Conda：Conda 環境管理器 (environment.yml)
• Docker：Docker 和 Docker Compose (Dockerfile, docker-compose.yml)
• PostgreSQL：數據庫配置和遷移
• C# (.NET)：.NET 項目 (*.csproj, *.sln)

構建工具和框架

• Webpack：Webpack 打包工具 (webpack.config.js)
• Rollup：Rollup 打包工具 (rollup.config.js)
• Sass/SCSS：Sass 預處理器 (*.scss, *.sass)
• Spring Framework：Spring Boot/Spring 框架 (application.properties, pom.xml)
• Apache Tomcat：Tomcat servlet 容器 (web.xml, context.xml)
• JBoss/WildFly：JBoss 應用服務器 (jboss-web.xml, standalone.xml)

貨幣化與許可

Dev-Env Sentinel 使用帶有功能標誌的免費增值模式：

• 免費版：基本的驗證和審計工具。
• 專業版：自動修復功能和高級特性。
• 企業版：Docker 編排和自定義配置。

快速開始

檢查許可證狀態：

# 通過 MCP 工具
check_license_status()

獲取專業版許可證信息：

# 通過 MCP 工具
get_pro_license()

激活許可證：

# 通過 MCP 工具
activate_pro(license_key="your-license-key")

支付選項

1. Stripe 支付鏈接 - 一次性或訂閱支付。
2. Apify 按事件付費 - 每次工具調用收費 $0.02 - $0.05。

詳細信息請參閱 docs/monetization.md。

添加新的生態系統

添加一種語言

在 config/languages/ 目錄下添加一個 YAML 配置文件，以支持基礎語言（例如，config/languages/go.yaml）。

添加一個工具

對於特定語言的工具，在 config/tools/{language}/ 目錄下添加一個 YAML 配置文件，其中 {language} 是該工具所使用的語言（例如，config/tools/java/maven.yaml）。

對於基礎設施工具，將它們添加到 config/infrastructure/ 下的相應子目錄中：

• Docker 工具：config/infrastructure/docker/
• 容器工具：config/infrastructure/containers/
• 數據庫工具：config/infrastructure/databases/{tool-name}/

無需更改代碼 - 系統會自動發現所有配置！

架構詳細信息請參閱 docs/architecture/configuration-schema.md。