init commit

Author: horw

.idea/.gitignore

@@ -0,0 +1 @@
+3.11.0

.python-version

@@ -0,0 +1,32 @@
+Currently, this MCP supports simple project builds with logging, and automatic issue fixing based on logs for esp-idf build command.
+
+### Install  
+
+First, clone this MCP repository:  
+
+```bash
+git clone [email protected]:horw/esp-mcp.git
+```  
+
+Then, configure it in your chatbot. 
+
+
+```json
+{
+    "mcpServers": {
+        "esp-run": {
+            "command": "/home/horw/.pyenv/shims/uv",
+            "args": [
+                "--directory",
+                "/home/horw/PycharmProjects/esp-mcp", <- your cloned path
+                "run",
+                "main.py"
+            ],
+            "env": {
+                "IDF_PATH": "~/esp-idf" <- your ESP-IDF path
+            }
+        }
+    }
+}
+```  
+![Result](./result.gif)

README.md

@@ -0,0 +1,53 @@
+"""
+Utility functions for ESP-IDF tools
+"""
+import os
+import asyncio
+from typing import Tuple
+
+
+async def run_command_async(command: str) -> Tuple[int, str, str]:
+    """Run a command asynchronously and capture output
+    
+    Args:
+        command: The command to run
+        
+    Returns:
+        Tuple[int, str, str]: Return code, stdout, stderr
+    """
+    try:
+        process = await asyncio.create_subprocess_shell(
+            command,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE
+        )
+        stdout, stderr = await process.communicate()
+        return process.returncode, stdout.decode(), stderr.decode()
+    except Exception as e:
+        return 1, "", f"Error executing command: {str(e)}"
+
+def get_esp_idf_dir() -> str:
+    """Get the ESP-IDF directory path
+    
+    Returns:
+        str: Path to the ESP-IDF directory
+    """
+
+    idf_dir = os.environ["IDF_PATH"]
+    return os.path.join(idf_dir, "esp-idf")
+
+def get_export_script() -> str:
+    """Get the path to the ESP-IDF export script
+    
+    Returns:
+        str: Path to the export script
+    """
+    return os.path.join(get_esp_idf_dir(), "export.sh")
+
+def check_esp_idf_installed() -> bool:
+    """Check if ESP-IDF is installed
+    
+    Returns:
+        bool: True if ESP-IDF is installed, False otherwise
+    """
+    return os.path.exists(get_esp_idf_dir())

esp_utils.py

@@ -0,0 +1,29 @@
+import logging
+
+from mcp.server.fastmcp import FastMCP
+import os
+from esp_utils import run_command_async, get_export_script
+
+mcp = FastMCP("esp-mcp")
+
+command_history = []
+
+@mcp.tool()
+async def build_esp_related_project(project_path: str) -> (str, str):
+    """Build an esp project.
+
+    Args:
+        project_path: Path to the ESP-IDF project
+
+    Returns:
+        str: Build logs
+    """
+    os.chdir(project_path)
+    export_script = get_export_script()
+    returncode, stdout, stderr = await run_command_async(f"bash -c 'source {export_script} && idf.py build'")
+    open('mcp-process.log', 'w+').write(str((stdout, stderr)))
+    logging.warning(f"build result {stdout} {stderr}")
+    return stdout, stderr
+
+if __name__ == '__main__':
+    mcp.run(transport='stdio')

main.py

@@ -0,0 +1,9 @@
+[project]
+name = "esp-mcp"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11.0"
+dependencies = [
+    "mcp[cli]>=1.5.0",
+]