Flutter MCP Server

🚀 Flutter MCP 服務器

Flutter MCP 服務器是 Model Context Protocol (MCP) 在 Dart 和 Flutter 生態系統中的開源實現，它能充當 AI 助手、開發工具與自動化工作流之間的橋樑，以安全、程序化且上下文感知的方式，實現 Dart 和 Flutter 開發任務的自動化。

🚀 快速開始

⚠️ 重要提示

Smithery 的雲部署尚未完成。此 MCP 服務器目前僅支持本地使用。Smithery 集成和 registry 列表功能暫未可用。

✨ 主要特性

該 MCP 服務器的功能

• 暴露 Dart & Flutter SDK 工具：將（analyze, format, fix, create, run, test）等工具作為可編程端點，允許 AI 代理、腳本或遠程客戶端通過 MCP 協議調用。
• 提供統一 API：可用於代碼分析、格式化、項目構建、運行測試等操作，支持遠程且安全地執行。
• 安全管理環境變量：運用最佳實踐，確保秘密和配置信息不被暴露。
• 支持資源端點：可用於文檔查詢、新聞和社區示例，方便 AI 客戶端檢索 Dart/Flutter 項目的相關信息。
• 支持平臺集成：設計用於與 Smithery 等平臺集成，也可在任何 Docker 兼容環境中本地運行或部署。

解決的問題

• 橋接 AI 和代碼之間的鴻溝：允許 AI 驅動的工具（如代碼助手、聊天機器人或 CI 代理）與真實的 Dart/Flutter 項目交互，調用工具並進行上下文感知的程序化操作。
• 自動化重複性任務：開發者和團隊能通過統一的安全界面自動執行代碼格式化、分析、測試和項目創建等操作。
• 標準化工具調用：消除自定義腳本或手動工具執行的需求，所有內容均通過一致且可發現的 API 暴露。
• 支持遠程和雲工作流：可在 CI/CD、雲平臺或 AI 驅動的開發管道中部署。
• 促進最佳實踐：通過環境變量處理秘密，支持容器化部署，並遵循開放標準進行協議和 API 設計。

功能完備性

• 工具端點：支持 analyze, format, fix, create, run, test 等 Dart 和 Flutter 工具的調用。
• 資源管理：可訪問與查詢文檔、示例代碼、新聞等資源。
• 環境變量支持：可通過環境變量配置服務器行為和功能。
• 擴展性：支持自定義插件和擴展，以滿足特定項目需求。

📦 安裝指南

本地安裝

1. 克隆倉庫：

   git clone https://github.com/your-repository/flutter-mcp-server.git
   cd flutter-mcp-server
   

2. 創建虛擬環境（推薦）並安裝依賴：

   python -m venv env
   source env/bin/activate  # 在 Windows 上使用 `env\Scripts\activate`
   pip install -r requirements.txt
   

3. 啟動服務器：

   python server.py
   

部署（Smithery）

1. 將項目倉庫與 Smithery 賬戶關聯。
2. 推送代碼更改以觸發構建。
3. 在 Smithery 界面中配置環境變量和部署參數。
4. 使用 Smithery 提供的 Playground 或兼容客戶端驗證服務器運行狀態。

📚 詳細文檔

配置說明

服務器設置

編輯 config.json 文件：

{
  "host": "localhost",
  "port": 5000,
  "debug_mode": true,
  "api_key": "your_api_key_here"
}

環境變量

在部署或運行時設置以下環境變量：

• FLUTTER_PATH：指定 Flutter 安裝路徑。
• DART-sdk_PATH：指定 Dart SDK 安裝路徑。
• MCP_SERVER_MODE：設置為 development 或 production。

💻 使用示例

基礎用法

通過 CLI 調用

# 分析代碼
mcp-server analyze --path ./my_project/

# 格式化代碼
mcp-server format --path ./my_project/ --fix

# 創建新項目
mcp-server create-project --name my_new_project --type flutter

通過 API 調用

使用 HTTP 請求：

curl -X POST http://localhost:5000/api/analyze \
     -H "Content-Type: application/json" \
     -d '{"path":"./my_project/"}'

📄 許可證

MIT