✨ feat: add react agent (#209)

Author: xyliugo

README.md

@@ -71,6 +71,8 @@ pip install -e .
 playwright install
 ```
 
+MCPMark defaults to the built-in orchestration agent (`MCPMarkAgent`). To experiment with the ReAct-style agent, pass `--agent react` to `pipeline.py` (other settings stay the same).
+
 Docker
 ```bash
 ./build-docker.sh

pipeline.py

@@ -14,6 +14,7 @@
 
 from src.logger import get_logger
 from src.evaluator import MCPEvaluator
+from src.agents import AGENT_REGISTRY
 from src.factory import MCPServiceFactory
 from src.model_config import ModelConfig
 
@@ -41,6 +42,13 @@ def main():
         required=True,
         help="Comma-separated list of models to evaluate (e.g., 'o3,k2,gpt-4.1')",
     )
+
+    parser.add_argument(
+        "--agent",
+        default="mcpmark",
+        choices=sorted(AGENT_REGISTRY.keys()),
+        help="Agent implementation to use (default: mcpmark)",
+    )
     parser.add_argument(
         "--tasks",
         default="all",
@@ -138,6 +146,7 @@ def main():
                 exp_name=run_exp_name,
                 output_dir=run_output_dir,
                 reasoning_effort=args.reasoning_effort,
+                agent_name=args.agent,
             )
 
             pipeline.run_evaluation(args.tasks)

src/agents/__init__.py

@@ -2,10 +2,17 @@
 MCPMark Agent Module
 ====================
 
-Provides a unified agent implementation using LiteLLM for model interactions
-and minimal MCP server management.
+Provides agent implementations and registry for MCPMark.
 """
 
+from .base_agent import BaseMCPAgent
 from .mcpmark_agent import MCPMarkAgent
+from .react_agent import ReActAgent
+
+AGENT_REGISTRY = {
+    "mcpmark": MCPMarkAgent,
+    "react": ReActAgent,
+}
+
+__all__ = ["BaseMCPAgent", "MCPMarkAgent", "ReActAgent", "AGENT_REGISTRY"]
 
-__all__ = ["MCPMarkAgent"]