add title to mcp server and improve instructions

Author: kentcdodds

exercises/01.ping/01.problem.connect/src/index.ts

@@ -3,8 +3,9 @@
 // import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 // 🐨 create a new McpServer
-// - it should have a name of 'EpicMe' and a version of '1.0.0'
+// - it should have a name of 'epicme', title of 'EpicMe', and a version of '1.0.0'
 // - it should have instructions for the LLM to know what this server can be used to do (we'll start out by saying it can solve math problems)
+// 💰 NOTE: the `instructions` should appear as a property of an object in the second argument of the McpServer constructor
 // 📜 If you're unsure how to do this, check out the MCP TypeScript SDK Docs:
 //   https://github.com/modelcontextprotocol/typescript-sdk
 

exercises/01.ping/01.solution.connect/src/index.ts

@@ -3,7 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/01.problem.simple/src/index.ts

@@ -3,7 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/01.solution.simple/src/index.ts

@@ -3,7 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/02.problem.args/src/index.ts

@@ -3,7 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/02.solution.args/src/index.ts

@@ -4,7 +4,8 @@ import { z } from 'zod'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/03.problem.errors/src/index.ts

@@ -4,7 +4,8 @@ import { z } from 'zod'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/03.solution.errors/src/index.ts

@@ -5,7 +5,8 @@ import { z } from 'zod'
 
 const server = new McpServer(
 	{
-		name: 'EpicMe',
+		name: 'epicme',
+		title: 'EpicMe',
 		version: '1.0.0',
 	},
 	{

exercises/02.tools/README.mdx

@@ -77,14 +77,21 @@ sequenceDiagram
 
 ## Example: Defining a Simple Tool
 
-```ts
+```ts lines=7
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 
 const server = new McpServer(
 	{ name: 'hello-world-server', version: '1.0.0' },
-	{ capabilities: { tools: {} }, instructions: 'A simple hello world server.' },
+	{
+		capabilities: {
+			// add the tools object to explicitly declare that this server supports tools
+			tools: {},
+		},
+		instructions: 'A simple hello world server.',
+	},
 )
 
+// register a tool with the server
 server.registerTool(
 	// llm-facing name
 	'hello',
@@ -93,10 +100,15 @@ server.registerTool(
 		title: 'Hello',
 		// llm-facing description (clients could also display this to the user)
 		description: 'Say hello',
+		// add a schema to validate the input
+		inputSchema: {
+			// the input description is llm-facing, (the user may see it as well)
+			name: z.string().describe('The name to say hello to'),
+		},
 	},
-	async () => {
+	async ({ name }) => {
 		return {
-			content: [{ type: 'text', text: 'Hello, world!' }],
+			content: [{ type: 'text', text: `Hello, ${name}!` }],
 		}
 	},
 )
@@ -111,7 +123,9 @@ Example client request:
 	"method": "tools/call",
 	"params": {
 		"name": "hello",
-		"arguments": {}
+		"arguments": {
+			"name": "Kody"
+		}
 	}
 }
 ```
@@ -126,7 +140,7 @@ Example server response:
 		"content": [
 			{
 				"type": "text",
-				"text": "Hello, world!"
+				"text": "Hello, Kody!"
 			}
 		],
 		"isError": false

exercises/03.resources/01.problem.simple/src/index.ts

@@ -9,7 +9,8 @@ export class EpicMeMCP {
 	db: DB
 	server = new McpServer(
 		{
-			name: 'EpicMe',
+			name: 'epicme',
+			title: 'EpicMe',
 			version: '1.0.0',
 		},
 		{