fixture: reference MCP server (echo/add/whoami); finding: arcade deploy is cloud-only

lib/mcp_server/.env.example

@@ -0,0 +1,13 @@
+# Environment variables for mcp_server MCP server
+#
+# Copy this file to .env and fill in your values:
+#   cp .env.example .env
+#
+# The .env file will be automatically discovered when running your server,
+# even from subdirectories like src/mcp_server/.
+#
+# IMPORTANT: Never commit your .env file to version control!
+
+# Example secret used by the whisper_secret tool
+# Replace with your actual secret value
+MY_SECRET_KEY="Your tools can have secrets injected at runtime!"

lib/mcp_server/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "mcp_server"
+version = "0.1.0"
+description = "MCP Server created with Arcade.dev"
+requires-python = ">=3.10"
+dependencies = [
+    "arcade-mcp-server>=1.17.0,<2.0.0",
+    "httpx>=0.28.0,<1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "arcade-mcp[all]>=1.15.0,<2.0.0",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+
+# Tell Arcade.dev that this package has Arcade tools
+[project.entry-points.arcade_toolkits]
+toolkit_name = "mcp_server"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_server"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.mypy]
+python_version = "3.12"
+warn_unused_configs = true
+disallow_untyped_defs = false

lib/mcp_server/src/mcp_server/server.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""arcade-eval reference MCP server.
+
+Deterministic, no-auth tools used as a shared eval fixture across categories:
+  - echo(text)  -> returns text unchanged            (protocol / curation / mixed-gateway)
+  - add(a, b)   -> a + b                              (deterministic invocation)
+  - whoami()    -> the calling user's id, server-side (per-user EXECUTION proof — cat 1/2)
+
+`whoami` reads `context.user_id`, which the Engine populates from the calling user's identity
+(the `Arcade-User-ID` header / auth-server `sub`). If a call as User A returns A and a call as
+User B returns B, the tool provably executes as the calling user.
+"""
+import sys
+from typing import Annotated
+
+from arcade_mcp_server import Context, MCPApp
+
+app = MCPApp(name="arcade_eval_ref", version="1.0.0")
+
+
+@app.tool
+def echo(text: Annotated[str, "Text to echo back"]) -> Annotated[str, "The same text"]:
+    """Echo the input text unchanged."""
+    return text
+
+
+@app.tool
+def add(
+    a: Annotated[int, "First addend"],
+    b: Annotated[int, "Second addend"],
+) -> Annotated[int, "The sum a + b"]:
+    """Add two integers."""
+    return a + b
+
+
+@app.tool
+def whoami(context: Context) -> Annotated[str, "The calling user's id as seen server-side"]:
+    """Return the calling user's identity as the server sees it (proves per-user execution)."""
+    return context.user_id or "<no user_id in context>"
+
+
+if __name__ == "__main__":
+    transport = sys.argv[1] if len(sys.argv) > 1 else "stdio"
+    app.run(transport=transport, host="127.0.0.1", port=8000)