add tests for sampling

kentcdodds · kentcdodds · commit 4602139777c6 · 2025-05-19T12:31:46.000-06:00
diff --git a/epicshop/.diffignore b/epicshop/.diffignore
@@ -0,0 +1,4 @@
+*.ignored.*
+*.ignored
+*.test.*
+package.json
diff --git a/exercises/01.ping/01.problem.connect/package.json b/exercises/01.ping/01.problem.connect/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/01.ping/01.solution.connect/package.json b/exercises/01.ping/01.solution.connect/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/01.problem.simple/package.json b/exercises/02.tools/01.problem.simple/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/01.solution.simple/package.json b/exercises/02.tools/01.solution.simple/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/02.problem.args/package.json b/exercises/02.tools/02.problem.args/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/02.solution.args/README.mdx b/exercises/02.tools/02.solution.args/README.mdx
@@ -27,8 +27,3 @@ Key learnings from this step:
 - How to return dynamic results based on user input
 
 You're now ready to build all sorts of powerful, parameterized tools!
-
-🧝‍♀️ In the next exercise, we're going to be working with a more real-world
-application, so I'm going to be adding a database and things. You'll have to
-integrate that, but if you've got a minute, you
-can <NextDiffLink>check out my changes</NextDiffLink> if you're curious.
diff --git a/exercises/02.tools/02.solution.args/package.json b/exercises/02.tools/02.solution.args/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/03.problem.errors/README.mdx b/exercises/02.tools/03.problem.errors/README.mdx
@@ -26,9 +26,9 @@ Example error response:
 Luckily for us, the MCP TypeScript SDK handles errors automatically. So all you
 need to do is throw an error from your tool, and the SDK will handle the rest!
 
-For this step, we're going to say that tag names cannot include the word
-"error". If it does, throw an error with a descriptive message and then try it
-out in the inspector. You'll notice the `isError` field is set to `true` and the
-content is the helpful error message you provided.
+For this step, we're going to say that the second number cannot be negative. If
+it is, throw an error with a descriptive message and then try it out in the
+inspector. You'll notice the `isError` field is set to `true` and the content is
+the helpful error message you provided.
 
 - [📜 MCP Spec: Errors](https://modelcontextprotocol.io/specification/2025-03-26/server/tools#error-handling)
diff --git a/exercises/02.tools/03.problem.errors/package.json b/exercises/02.tools/03.problem.errors/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/02.tools/03.solution.errors/package.json b/exercises/02.tools/03.solution.errors/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/01.problem.simple/package.json b/exercises/03.resources/01.problem.simple/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/01.problem.simple/src/index.ts b/exercises/03.resources/01.problem.simple/src/index.ts
@@ -37,7 +37,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/03.resources/01.solution.simple/package.json b/exercises/03.resources/01.solution.simple/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/01.solution.simple/src/index.ts b/exercises/03.resources/01.solution.simple/src/index.ts
@@ -36,7 +36,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/03.resources/02.problem.template/package.json b/exercises/03.resources/02.problem.template/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/02.problem.template/src/index.ts b/exercises/03.resources/02.problem.template/src/index.ts
@@ -36,7 +36,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/03.resources/02.solution.template/package.json b/exercises/03.resources/02.solution.template/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/02.solution.template/src/index.ts b/exercises/03.resources/02.solution.template/src/index.ts
@@ -36,7 +36,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/03.resources/03.problem.embedded/package.json b/exercises/03.resources/03.problem.embedded/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/03.problem.embedded/src/index.ts b/exercises/03.resources/03.problem.embedded/src/index.ts
@@ -36,7 +36,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/03.resources/03.solution.embedded/package.json b/exercises/03.resources/03.solution.embedded/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/03.resources/03.solution.embedded/src/index.ts b/exercises/03.resources/03.solution.embedded/src/index.ts
@@ -36,7 +36,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/04.prompts/01.problem.prompts/package.json b/exercises/04.prompts/01.problem.prompts/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/04.prompts/01.problem.prompts/src/index.ts b/exercises/04.prompts/01.problem.prompts/src/index.ts
@@ -41,7 +41,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/04.prompts/01.solution.prompts/package.json b/exercises/04.prompts/01.solution.prompts/package.json
@@ -15,11 +15,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/04.prompts/01.solution.prompts/src/index.ts b/exercises/04.prompts/01.solution.prompts/src/index.ts
@@ -39,7 +39,7 @@ You can also help users add tags to their entries and get all tags for an entry.
 }
 
 async function main() {
-	const agent = new EpicMeMCP('./db.sqlite')
+	const agent = new EpicMeMCP(process.env.EPIC_ME_DB_PATH ?? './db.sqlite')
 	await agent.init()
 	const transport = new StdioServerTransport()
 	await agent.server.connect(transport)
diff --git a/exercises/05.sampling/01.problem.simple/package.json b/exercises/05.sampling/01.problem.simple/package.json
@@ -2,6 +2,11 @@
   "name": "exercises_05.sampling_01.problem.simple",
   "private": true,
   "type": "module",
+  "epicshop": {
+    "testTab": {
+      "enabled": true
+    }
+  },
   "scripts": {
     "dev": "mcp-dev",
     "dev:mcp": "tsx src/index.ts",
@@ -15,11 +20,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@epic-web/mcp-dev": "*",
-    "tsx": "^4.19.3",
     "@epic-web/config": "^1.19.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
     "@kentcdodds/tmp-modelcontextprotocol_inspector": "^0.12.0-alpha.4",
     "@types/node": "^22.15.2",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
diff --git a/exercises/05.sampling/01.problem.simple/src/index.test.ts b/exercises/05.sampling/01.problem.simple/src/index.test.ts
diff --git a/exercises/05.sampling/01.problem.simple/src/index.ts b/exercises/05.sampling/01.problem.simple/src/index.ts
diff --git a/exercises/05.sampling/01.solution.simple/package.json b/exercises/05.sampling/01.solution.simple/package.json
diff --git a/exercises/05.sampling/01.solution.simple/src/index.test.ts b/exercises/05.sampling/01.solution.simple/src/index.test.ts
diff --git a/exercises/05.sampling/01.solution.simple/src/index.ts b/exercises/05.sampling/01.solution.simple/src/index.ts
diff --git a/exercises/05.sampling/02.problem.advanced/package.json b/exercises/05.sampling/02.problem.advanced/package.json
diff --git a/exercises/05.sampling/02.problem.advanced/src/index.test.ts b/exercises/05.sampling/02.problem.advanced/src/index.test.ts
diff --git a/exercises/05.sampling/02.problem.advanced/src/index.ts b/exercises/05.sampling/02.problem.advanced/src/index.ts
diff --git a/exercises/05.sampling/02.solution.advanced/package.json b/exercises/05.sampling/02.solution.advanced/package.json
diff --git a/exercises/05.sampling/02.solution.advanced/src/index.test.ts b/exercises/05.sampling/02.solution.advanced/src/index.test.ts
diff --git a/exercises/05.sampling/02.solution.advanced/src/index.ts b/exercises/05.sampling/02.solution.advanced/src/index.ts
diff --git a/package-lock.json b/package-lock.json
