chore: Move common path discovery to a utils script

Author: andrewginns

agents_mcp_usage/basic_mcp/basic_mcp_use/langgraph_mcp.py

@@ -9,6 +9,8 @@
 from mcp import ClientSession, StdioServerParameters
 from mcp.client.stdio import stdio_client
 
+from agents_mcp_usage.utils import get_mcp_server_path
+
 load_dotenv()
 
 # Configure logging if LOGFIRE_TOKEN is set
@@ -21,7 +23,7 @@
 # Create server parameters for stdio connection
 server = StdioServerParameters(
     command="uv",
-    args=["run", "mcp_servers/example_server.py", "stdio"],
+    args=["run", str(get_mcp_server_path("example_server.py")), "stdio"],
 )
 
 model = ChatGoogleGenerativeAI(

agents_mcp_usage/basic_mcp/basic_mcp_use/oai-agent_mcp.py

@@ -5,6 +5,8 @@
 from agents.mcp import MCPServerStdio
 from dotenv import load_dotenv
 
+from agents_mcp_usage.utils import get_mcp_server_path
+
 load_dotenv()
 
 # Configure Logfire
@@ -26,7 +28,7 @@ async def main(query: str = "Greet Andrew and give him the current time") -> Non
     async with MCPServerStdio(
         params={
             "command": "uv",
-            "args": ["run", "mcp_servers/example_server.py", "stdio"],
+            "args": ["run", str(get_mcp_server_path("example_server.py")), "stdio"],
         }
     ) as server:
         # Initialise the agent with the server

agents_mcp_usage/basic_mcp/basic_mcp_use/pydantic_mcp.py

@@ -5,6 +5,8 @@
 from pydantic_ai import Agent
 from pydantic_ai.mcp import MCPServerStdio
 
+from agents_mcp_usage.utils import get_mcp_server_path
+
 load_dotenv()
 
 # Configure logging to logfire if LOGFIRE_TOKEN is set in environment
@@ -16,7 +18,7 @@
     command="uv",
     args=[
         "run",
-        "mcp_servers/example_server.py",
+        str(get_mcp_server_path("example_server.py")),
         "stdio",
     ],
 )

agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py

@@ -37,7 +37,9 @@
     invalid_mermaid_diagram_hard,
     valid_mermaid_diagram,
 )
-from mcp_servers.mermaid_validator import validate_mermaid_diagram
+from agents_mcp_usage.utils import get_mcp_server_path
+import sys
+import importlib.util
 
 load_dotenv()
 
@@ -57,6 +59,14 @@
 BASE_RETRY_DELAY = 1.0  # seconds
 MAX_RETRY_DELAY = 30.0  # seconds
 
+# Dynamically import validate_mermaid_diagram from the mermaid_validator.py file
+mermaid_validator_path = str(get_mcp_server_path("mermaid_validator.py"))
+spec = importlib.util.spec_from_file_location("mermaid_validator", mermaid_validator_path)
+mermaid_validator = importlib.util.module_from_spec(spec)
+sys.modules["mermaid_validator"] = mermaid_validator
+spec.loader.exec_module(mermaid_validator)
+validate_mermaid_diagram = mermaid_validator.validate_mermaid_diagram
+
 # ============================================================================
 # Retry Utilities
 # ============================================================================
@@ -177,15 +187,15 @@ def get_mcp_servers() -> List[MCPServerStdio]:
         command="uv",
         args=[
             "run",
-            "mcp_servers/example_server.py",
+            str(get_mcp_server_path("example_server.py")),
             "stdio",
         ],
     )
     mermaid_server = MCPServerStdio(
         command="uv",
         args=[
             "run",
-            "mcp_servers/mermaid_validator.py",
+            str(get_mcp_server_path("mermaid_validator.py")),
         ],
     )
     return [local_server, mermaid_server]

agents_mcp_usage/multi_mcp/multi_mcp_use/adk_mcp.py

@@ -31,6 +31,7 @@
 from google.genai import types
 
 from agents_mcp_usage.multi_mcp.mermaid_diagrams import invalid_mermaid_diagram_easy
+from agents_mcp_usage.utils import get_mcp_server_path
 
 load_dotenv()
 
@@ -62,7 +63,7 @@ async def get_tools_async() -> tuple[list, list]:
         command="uv",
         args=[
             "run",
-            "mcp_servers/example_server.py",
+            str(get_mcp_server_path("example_server.py")),
             "stdio",
         ],
     )
@@ -71,7 +72,7 @@ async def get_tools_async() -> tuple[list, list]:
         command="uv",
         args=[
             "run",
-            "mcp_servers/mermaid_validator.py",
+            str(get_mcp_server_path("mermaid_validator.py")),
         ],
     )
 

agents_mcp_usage/multi_mcp/multi_mcp_use/pydantic_mcp.py

@@ -8,6 +8,7 @@
 from pydantic_ai.usage import UsageLimits
 
 from agents_mcp_usage.multi_mcp.mermaid_diagrams import invalid_mermaid_diagram_easy
+from agents_mcp_usage.utils import get_mcp_server_path
 
 load_dotenv()
 
@@ -21,15 +22,15 @@
     command="uv",
     args=[
         "run",
-        "mcp_servers/example_server.py",
+        str(get_mcp_server_path("example_server.py")),
         "stdio",
     ],
 )
 mermaid_server = MCPServerStdio(
     command="uv",
     args=[
         "run",
-        "mcp_servers/mermaid_validator.py",
+        str(get_mcp_server_path("mermaid_validator.py")),
     ],
 )
 # Create Agent with MCP servers

agents_mcp_usage/utils.py

@@ -0,0 +1,28 @@
+"""Utility functions and constants for the agents-mcp-usage project."""
+
+from pathlib import Path
+
+# Get the project root directory (where pyproject.toml is located)
+# This is 2 levels up from this utils.py file: agents_mcp_usage/utils.py -> agents-mcp-usage/
+PROJECT_ROOT = Path(__file__).parent.parent.resolve()
+
+
+def get_project_root() -> Path:
+    """Get the absolute path to the project root directory.
+
+    Returns:
+        Path: The absolute path to the project root where pyproject.toml is located.
+    """
+    return PROJECT_ROOT
+
+
+def get_mcp_server_path(server_name: str) -> Path:
+    """Get the absolute path to an MCP server file.
+
+    Args:
+        server_name: The name of the MCP server file (e.g., "example_server.py")
+
+    Returns:
+        Path: The absolute path to the MCP server file.
+    """
+    return PROJECT_ROOT / "mcp_servers" / server_name