editor-mcp

Instructions

Implementation Reference

• src/text_editor/server.py:1125-1168 (handler)

  Main handler for the 'run_tests' MCP tool. Validates Python venv, builds pytest CLI arguments based on inputs, and delegates execution to the internal _run_tests helper.
  async def run_tests( test_path: Optional[str] = None, test_name: Optional[str] = None, verbose: bool = False, collect_only: bool = False, ) -> Dict[str, Any]: """ Run pytest tests using the specified Python virtual environment. Args: test_path (str, optional): Directory or file path containing tests to run test_name (str, optional): Specific test function/method to run verbose (bool, optional): Run tests in verbose mode collect_only (bool, optional): Only collect tests without executing them Returns: dict: Test execution results including returncode, output, and execution time """ if self.python_venv is None: return { "error": "No Python environment found. It needs to be set in the MCP config as environment variable called PYTHON_VENV." } # Build pytest arguments pytest_args = [] # Add test path if specified if test_path: pytest_args.append(test_path) # Add specific test name if specified if test_name: pytest_args.append(f"-k {test_name}") # Add verbosity flag if specified if verbose: pytest_args.append("-v") # Add collect-only flag if specified if collect_only: pytest_args.append("--collect-only") # Run the tests return self._run_tests(pytest_args)
• src/text_editor/server.py:1429-1482 (helper)

  Helper method that runs pytest subprocess, captures stdout/stderr/returncode, computes duration, and formats results as dict with status.
  def _run_tests(self, pytest_args=None, python_venv=None): """ Run pytest tests using the specified Python virtual environment. Args: pytest_args (list, optional): List of arguments to pass to pytest python_venv (str, optional): Path to Python executable in virtual environment If not provided, uses PYTHON_VENV environment variable Returns: dict: Test execution results including returncode, output, and execution time """ try: # Determine the Python executable to use python_venv = ( python_venv or self.python_venv ) # Use the class level python_venv # If no venv is specified, use the system Python python_cmd = python_venv or "python" # Build the command to run pytest cmd = [python_cmd, "-m", "pytest"] # Add any additional pytest arguments if pytest_args: cmd.extend(pytest_args) # Record the start time start_time = datetime.datetime.now() # Run the pytest command process = subprocess.run(cmd, capture_output=True, text=True) # Record the end time and calculate duration end_time = datetime.datetime.now() duration = (end_time - start_time).total_seconds() # Return the results return { "status": "success" if process.returncode == 0 else "failure", "returncode": process.returncode, "stdout": process.stdout, "stderr": process.stderr, "duration": duration, "command": " ".join(cmd), } except Exception as e: return { "status": "error", "error": str(e), "command": " ".join(cmd) if "cmd" in locals() else None, }
• src/text_editor/server.py:1118-1123 (helper)

  Supporting tool to set PYTHONPATH environment variable before running tests to aid in module discovery.
  async def set_python_path(path: str): """ Set it before running tests so the project is correctly recognized """ os.environ["PYTHONPATH"] = path
• src/text_editor/server.py:1125-1168 (registration)

  Registration of the run_tests tool via FastMCP decorator within TextEditorServer.register_tools() method.
  async def run_tests( test_path: Optional[str] = None, test_name: Optional[str] = None, verbose: bool = False, collect_only: bool = False, ) -> Dict[str, Any]: """ Run pytest tests using the specified Python virtual environment. Args: test_path (str, optional): Directory or file path containing tests to run test_name (str, optional): Specific test function/method to run verbose (bool, optional): Run tests in verbose mode collect_only (bool, optional): Only collect tests without executing them Returns: dict: Test execution results including returncode, output, and execution time """ if self.python_venv is None: return { "error": "No Python environment found. It needs to be set in the MCP config as environment variable called PYTHON_VENV." } # Build pytest arguments pytest_args = [] # Add test path if specified if test_path: pytest_args.append(test_path) # Add specific test name if specified if test_name: pytest_args.append(f"-k {test_name}") # Add verbosity flag if specified if verbose: pytest_args.append("-v") # Add collect-only flag if specified if collect_only: pytest_args.append("--collect-only") # Run the tests return self._run_tests(pytest_args)