diff --git a/app/public/characters.json b/app/public/characters.json
index 0ce7ce20..8206d452 100644
--- a/app/public/characters.json
+++ b/app/public/characters.json
@@ -43,5 +43,23 @@
"image": "ada.jpeg",
"avatar": "ada-avatar.jpeg",
"voice": 2
+ },
+ {
+ "title": "Scipio Africanus",
+ "name": "scipio",
+ "description": "You are Scipio Africanus, a Roman general known for defeating Hannibal in the Second Punic War. Limit your responses to only the time you live in, you don't know anything else. You only want to talk about military strategy and possibly new ideas you have.",
+ "page": "scipio.html",
+ "image": "scipio.png",
+ "avatar": "scipio-avatar.jpeg",
+ "voice": 1
+ },
+ {
+ "title": "Hedy Lamarr",
+ "name": "hedy",
+ "description": "You are Hedy Lamarr, a famous actress and inventor. Limit your responses to only the time you live in, you don't know anything else. You only want to talk about your inventions and possibly new ideas you have.",
+ "page": "hedy.html",
+ "image": "hedy.jpeg",
+ "avatar": "hedy-avatar.jpeg",
+ "voice": 2
}
]
diff --git a/app/public/images/hedy-avatar.jpeg b/app/public/images/hedy-avatar.jpeg
new file mode 100644
index 00000000..7856b43c
Binary files /dev/null and b/app/public/images/hedy-avatar.jpeg differ
diff --git a/app/public/images/hedy.jpeg b/app/public/images/hedy.jpeg
new file mode 100644
index 00000000..5fd297ce
Binary files /dev/null and b/app/public/images/hedy.jpeg differ
diff --git a/app/public/images/scipio-avatar.jpeg b/app/public/images/scipio-avatar.jpeg
new file mode 100644
index 00000000..c3aa2189
Binary files /dev/null and b/app/public/images/scipio-avatar.jpeg differ
diff --git a/app/public/images/scipio.png b/app/public/images/scipio.png
new file mode 100644
index 00000000..d72e8da1
Binary files /dev/null and b/app/public/images/scipio.png differ
diff --git a/lessons/07-mcp/README.md b/lessons/07-mcp/README.md
new file mode 100644
index 00000000..481048ad
--- /dev/null
+++ b/lessons/07-mcp/README.md
@@ -0,0 +1,482 @@
+# MCP, Model Context Protocol
+
+In this chapter you will learn:
+
+- How to use the Model Context Protocol, MCP to split up your server capabilities in a server and a client
+- Create tools, resources and prompts on the server.
+- Consume the server using both the inspector tool and a written client.
+
+## Setup
+
+If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
+
+## Related resources
+
+[](https://www.youtube.com/watch?v=YRfOiB0Im64)
+
+_This video explains Model Context Protocol._
+
+*🎥 Click on the image above to watch a short video about MCP*
+
+## Narrative: Scipio Africanus
+
+> [!NOTE]
+> _Our story so far. You are a mechanic from 1860s London. You were working on your automaton and received a letter from Charles Babbage that ended up taking you to a library where you picked up a time travel device. Throughout your travels in time you've ended up in Florence, where you met Leonardo Da Vinci. You also went to the Aztec empire and this is where the story continues._
+>
+> See [Lesson 1](../01-intro-to-genai/README.md) if you want to catch up with the story from the beginning.
+
+> [!NOTE]
+> While we recommend going through the story (it's fun!), [click here](#interact-with-scipio) if you'd prefer to jump straight to the technical content.
+
+_Our heroes had just learned tools and using tools via tool calling inspired by their meeting with Amelia Earhart and is now returning back to Ada Lovelace's mansion to discuss their new found knowledge. A flash of light envelops our heroes as the time beetle transports them back to Aaa's present. They find themselves in the basement of Ada Lovelace's mansion, Charles Babbage is not present, but Ada is there waiting for them. She is excited to hear about their journey and the knowledge they've gained._
+
+**Ada**: "Welcome back! I trust your journey was enlightening."
+
+**You**: "It was! meeting with mrs Earhart was quite the experience. She taught us about the importance of tools and how to use them effectively."
+
+**Ada**: "There are few people who understand the importance of tools better than Amelia. I trust you've also upgraded her time beetle?"
+
+**You**: "Yes, we did! So what's next on the agenda?"
+
+**Ada**: "Tool calling is definitely a powerful concept, one that improves your device. However, it lacks a certain "finesse" shall we say. We need to learn _how to make it scale_, we need a protocol. I know just the fellow to help us with that. His name is Scipio Africanus, a great military strategist from ancient Rome. Too bad he spent all his time with military strategy, I'm sure he would have been a brilliant engineer. Off you go.
+
+**You**: "Scipio Africanus? I think I remember him from history class.
+
+**Ada**: "Good then, why are you still here? Time is off the essence. Ta ta"
+
+The swirling of light envelops you again and you find yourself in a large room with a large table in the middle. The walls are adorned with maps and military strategies. Scipio Africanus is standing at the table, deep in thought. He looks up as you enter. "Ada te misit/Ada sent you?"
+
+
+
+
+
+
+ ✅ Answer
+
+ * **C. Tools, Resources and Prompts**
+
+
+
+### ❓ Question 2:
+
+### What are some ways you can test your MCP Server?
+
+
+ ✅ Answer
+
+ * **E. All of the above**
+
+
+
+
+
diff --git a/lessons/07-mcp/solution/src/client.ts b/lessons/07-mcp/solution/src/client.ts
new file mode 100644
index 00000000..77584f0c
--- /dev/null
+++ b/lessons/07-mcp/solution/src/client.ts
@@ -0,0 +1,36 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+const transport = new StdioClientTransport({
+ command: "node",
+ args: ["build/index.js"]
+});
+
+const client = new Client(
+ {
+ name: "example-client",
+ version: "1.0.0"
+ }
+);
+
+await client.connect(transport);
+
+
+// List resources
+const resources = await client.listResources();
+console.log("Available resources:", resources);
+
+// read a resource
+let resource = await client.readResource({
+ uri: "scrolls://tactics.txt",
+});
+
+console.log("Resource contents:", resource.contents);
+
+// Read a resource
+resource = await client.readResource({
+ uri: "echo://hello",
+});
+
+console.log("Resource contents:", resource.contents);
+
diff --git a/lessons/07-mcp/solution/src/index.ts b/lessons/07-mcp/solution/src/index.ts
new file mode 100644
index 00000000..09cf814a
--- /dev/null
+++ b/lessons/07-mcp/solution/src/index.ts
@@ -0,0 +1,114 @@
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { promises as fs } from "fs";
+import path from "path";
+
+
+// Create an MCP server
+const server = new McpServer({
+ name: "Demo",
+ version: "1.0.0"
+});
+
+// Add an addition tool
+server.tool("add",
+ { a: z.number(), b: z.number() },
+ async ({ a, b }) => ({
+ content: [{ type: "text", text: String(a + b) }]
+ })
+);
+
+server.tool("subtract",
+ { a: z.number(), b: z.number() },
+ async ({ a, b }) => ({
+ content: [{ type: "text", text: String(a - b) }]
+ })
+);
+
+server.tool("divide",
+ { a: z.number(), b: z.number() },
+ async ({ a, b }) => ({
+ content: [{ type: "text", text: String(a / b) }]
+ })
+);
+
+server.tool("multiply",
+ { a: z.number(), b: z.number() },
+ async ({ a, b }) => ({
+ content: [{ type: "text", text: String(a * b) }]
+ })
+);
+
+server.resource(
+ "echo",
+ new ResourceTemplate("echo://{message}", { list: () => {
+ return {
+ resources: [
+ {
+ "name": "echo",
+ "description": "Echo a message",
+ "mimeType": "text/plain",
+ "uri": "echo://{message}"
+ }
+ ]
+ };
+ } }),
+ async (uri, { message }) => ({
+ contents: [{
+ uri: uri.href,
+ text: `Resource echo: ${message}`
+ }]
+ })
+);
+
+// Add a dynamic greeting resource
+server.resource(
+ "scrolls",
+ new ResourceTemplate("scrolls://{name}", { list: () => {
+ return {
+ resources: [
+ {
+ "name": "scrolls",
+ "description": "Scrolls resource",
+ "mimeType": "text/plain",
+ "uri": "scrolls://{name}"
+ }
+ ]
+ };
+ }}),
+ async (uri, { name }) => {
+ // open file to check if it exist
+ let fileContent: string;
+ let filePath = path.join(process.cwd(), "scrolls", `${name}`);
+ try {
+ console.log("File path: ", filePath);
+
+ fileContent = await fs.readFile(filePath, "utf-8");
+ } catch (err) {
+ fileContent = `File ${name} not found in ${filePath}`;
+ console.error(fileContent);
+ }
+ // response with file content
+
+ return {
+ contents: [{
+ uri: uri.href,
+ text: fileContent
+ }]
+ }
+ }
+);
+
+// Start receiving messages on stdin and sending messages on stdout
+
+async function main() {
+ const transport = new StdioServerTransport();
+ await server.connect(transport);
+ console.error("MCPServer started on stdin/stdout");
+}
+
+main().catch((error) => {
+ console.error("Fatal error: ", error);
+ process.exit(1);
+});
diff --git a/lessons/07-mcp/solution/tsconfig.json b/lessons/07-mcp/solution/tsconfig.json
new file mode 100644
index 00000000..a14bee07
--- /dev/null
+++ b/lessons/07-mcp/solution/tsconfig.json
@@ -0,0 +1,15 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "Node16",
+ "moduleResolution": "Node16",
+ "outDir": "./build",
+ "rootDir": "./src",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules"]
+}
diff --git a/lessons/08-mcp-advanced/README.md b/lessons/08-mcp-advanced/README.md
new file mode 100644
index 00000000..b6eee11b
--- /dev/null
+++ b/lessons/08-mcp-advanced/README.md
@@ -0,0 +1,264 @@
+# MCP part II
+
+In our previous lesson, we learned how to create an MCP Server and how this is a good way to separate an AI app from it's cabilities. We saw how we could add capabilities like tools and resources. Additionally, we showed how the server could be consumed by both an inspector tool or a written client. We've only scratched the surface of what MCP can do, and in this chapter we'll add an LLM to the client so you can see how this creates a better user experience.
+
+In this chapter you will learn to:
+
+- Augment your client with an LLM.
+- Use your improved client to convert an MCP Server response to a tool.
+- Leverage your improved client to create a more natural user interaction.
+
+## Setup
+
+If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
+
+## Related resources
+
+[](https://www.youtube.com/watch?v=YRfOiB0Im64)
+
+_This video explains Model Context Protocol LLM usage._
+
+*🎥 Click on the image above to watch a short video about MCP*
+
+
+## Narrative: Hedwig "Hedy" Lamarr
+
+> [!NOTE]
+> _Our story so far. You are a mechanic from 1860s London. You were working on your automaton and received a letter from Charles Babbage that ended up taking you to a library where you picked up a time travel device. Throughout your travels in time you've ended up in Florence, where you met Leonardo Da Vinci. You also went to the Aztec empire and this is where the story continues._
+>
+> See [Lesson 1](../01-intro-to-genai/README.md) if you want to catch up with the story from the beginning.
+
+> [!NOTE]
+> While we recommend going through the story (it's fun!), [click here](#interact-with-hedy-lamarr) if you'd prefer to jump straight to the technical content.
+
+You once again travelled back to Ada's mansion. This time Ada was meeting you at the main gates.
+
+**Ada**: Well, how did it go?
+
+**You**: Good I think, we managed to get this app working. You showing the progress to Ada.
+
+**Ada**: She takes the device up, tries it out and fiddles it and to herself murmurs, mm hm, ah I see, yea, yea no good. It won't do I'm afaid she states a bit louder, lacks a certain finesse.
+
+**You**: I was thinking that too, we need to be able to type or speak to it right?
+
+**Ada**: Right, I know just the person to help us. In fact, I'll come with you for this one, been too long since we met. Time Beetle, Hollywood please 1940, residence of Hedy Lamarr.
+
+Everything went dark, colors swirling, moments later your eyes start to make out a scene, a man sitting by a piano next to a woman with dark brown and curly hair both speaking in an excited way gesticulating.
+
+
+
+
+
+
+ ✅ Answer
+
+ * **B. Creates a more natural conversation between user and server.**
+
+ While it's easier to maintain the client and the server by separating responsibilities, the great value of having the LLM on the client is that the user doesn't have to explicitly invoke server capabilities but can in a more seamless way either receive generic LLM responses or responses from an MCP Server.
+
+
+
diff --git a/lessons/08-mcp-advanced/solutions/src/client.ts b/lessons/08-mcp-advanced/solutions/src/client.ts
new file mode 100644
index 00000000..40ccc0b8
--- /dev/null
+++ b/lessons/08-mcp-advanced/solutions/src/client.ts
@@ -0,0 +1,134 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import OpenAI from "openai";
+import { z } from "zod"; // Import zod for schema validation
+
+class MyClient {
+ private openai: OpenAI;
+ private client: Client;
+ constructor(){
+ this.openai = new OpenAI({
+ baseURL: "https://models.inference.ai.azure.com", // might need to change to this url in the future: https://models.github.ai/inference
+ apiKey: process.env.GITHUB_TOKEN,
+ });
+
+
+
+ this.client = new Client(
+ {
+ name: "example-client",
+ version: "1.0.0"
+ },
+ {
+ capabilities: {
+ prompts: {},
+ resources: {},
+ tools: {}
+ }
+ }
+ );
+ }
+
+ async connectToServer(transport: Transport) {
+ await this.client.connect(transport);
+ this.run();
+ console.error("MCPClient started on stdin/stdout");
+ }
+
+ openAiToolAdapter(tool: {
+ name: string;
+ description?: string;
+ input_schema: any;
+ }) {
+ // Create a zod schema based on the input_schema
+ const schema = z.object(tool.input_schema);
+
+ return {
+ type: "function" as const, // Explicitly set type to "function"
+ function: {
+ name: tool.name,
+ description: tool.description,
+ parameters: {
+ type: "object",
+ properties: tool.input_schema.properties,
+ required: tool.input_schema.required,
+ },
+ },
+ };
+ }
+
+ async callTools(
+ tool_calls: OpenAI.Chat.Completions.ChatCompletionMessageToolCall[],
+ toolResults: any[]
+ ) {
+ for (const tool_call of tool_calls) {
+ const toolName = tool_call.function.name;
+ const args = tool_call.function.arguments;
+
+ console.log(`Calling tool ${toolName} with args ${JSON.stringify(args)}`);
+
+
+ // 2. Call the server's tool
+ const toolResult = await this.client.callTool({
+ name: toolName,
+ arguments: JSON.parse(args),
+ });
+
+ console.log("Tool result: ", toolResult);
+
+ // 3. Do something with the result
+ // TODO for you to implement
+
+ }
+ }
+
+ async run() {
+ console.log("Asking server for available tools");
+ const toolsResult = await this.client.listTools();
+ const tools = toolsResult.tools.map((tool) => {
+ return this.openAiToolAdapter({
+ name: tool.name,
+ description: tool.description,
+ input_schema: tool.inputSchema,
+ });
+ });
+
+ const messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[] = [
+ {
+ role: "user",
+ content: "Tell me about Ada Lovelace",
+ },
+ ];
+
+ console.log("Querying LLM: ", messages[0].content);
+ let response = await this.openai.chat.completions.create({
+ model: "gpt-4o-mini",
+ max_tokens: 1000,
+ messages,
+ tools: tools,
+ });
+
+ console.log("LLM response: ", response.choices[0].message.content);
+
+ let results: any[] = [];
+
+ // 1. Go through the LLM response,for each choice, check if it has tool calls
+ response.choices.map(async (choice: { message: any; }) => {
+ const message = choice.message;
+ if (message.tool_calls) {
+ console.log("Making tool call")
+ await this.callTools(message.tool_calls, results);
+ }
+ });
+ }
+
+}
+
+let client = new MyClient();
+ const transport = new StdioClientTransport({
+ command: "node",
+ args: ["./build/index.js"]
+ });
+
+client.connectToServer(transport);
diff --git a/lessons/08-mcp-advanced/solutions/src/index.ts b/lessons/08-mcp-advanced/solutions/src/index.ts
new file mode 100644
index 00000000..da3b7a3f
--- /dev/null
+++ b/lessons/08-mcp-advanced/solutions/src/index.ts
@@ -0,0 +1,63 @@
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { promises as fs } from "fs";
+import path from "path";
+
+
+// Create an MCP server
+const server = new McpServer({
+ name: "Demo",
+ version: "1.0.0"
+});
+
+// Add a tool
+server.tool("characterDetails",
+ { name: z.string() },
+ async ({ name }) => {
+
+ console.log(`Received character name: ${name}`);
+
+ const url = `https://en.wikipedia.org/api/rest_v1/page/summary/${encodeURIComponent(name)}`; // Changed 'title' to 'name'
+ const response = await fetch(url);
+ if (!response.ok) throw new Error("Failed to fetch character details");
+ const data = await response.json();
+ const responseText = data.extract; // This contains the summary text
+
+ return {
+ content: [{ type: "text", text: `Character: ${responseText}` }]
+ };
+ }
+);
+
+// Add a tool
+server.tool("place",
+ { name: z.string() },
+ async ({ name }) => {
+
+ console.log(`Received name of place: ${name}`);
+
+ const url = `https://en.wikipedia.org/api/rest_v1/page/summary/${encodeURIComponent(name)}`; // Changed 'title' to 'name'
+ const response = await fetch(url);
+ if (!response.ok) throw new Error("Failed to fetch place details");
+ const data = await response.json();
+ const responseText = data.extract; // This contains the summary text
+
+ return {
+ content: [{ type: "text", text: `Place: ${responseText}` }]
+ };
+ }
+);
+
+// Start receiving messages on stdin and sending messages on stdout
+
+async function main() {
+ const transport = new StdioServerTransport();
+ await server.connect(transport);
+ console.error("MCPServer started on stdin/stdout");
+}
+
+main().catch((error) => {
+ console.error("Fatal error: ", error);
+ process.exit(1);
+});
diff --git a/lessons/08-mcp-advanced/solutions/tsconfig.json b/lessons/08-mcp-advanced/solutions/tsconfig.json
new file mode 100644
index 00000000..b01bd618
--- /dev/null
+++ b/lessons/08-mcp-advanced/solutions/tsconfig.json
@@ -0,0 +1,16 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "Node16",
+ "moduleResolution": "Node16",
+ "outDir": "./build",
+ "rootDir": "./src",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true,
+ "noImplicitAny": false
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules"]
+}
diff --git a/lessons/09-mcp-sse/README.md b/lessons/09-mcp-sse/README.md
new file mode 100644
index 00000000..5cb48a67
--- /dev/null
+++ b/lessons/09-mcp-sse/README.md
@@ -0,0 +1,77 @@
+## Lesson 9: MCP Server with SSE
+
+In our previous lessons on MCP, we learned how to create an MCP Server, a client and we were introduced to some tooling that make developing things for MCP protocol a bit easier. Additionally we learned to improve the client with an LLM. So far, you've been using stdio as transport for your server, but in reality a server may run anywhere on a specific URL for example. For this type of situation there's another transport SSE.
+
+In this chapter you will learn to:
+
+- Create an MCP Server using the SSE transport.
+- Learn to test said server with our Inspector tool.
+- Consume an SSE server using Visual Studio Code.
+
+## Setup
+
+If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
+
+## Related resources
+
+[](https://www.youtube.com/watch?v=YRfOiB0Im64)
+
+_This video explains Model Context Protocol LLM usage._
+
+*🎥 Click on the image above to watch a short video about MCP*
+
+## Narrative: Guardians of time
+
+> [!NOTE]
+> _Our story so far. You are a mechanic from 1860s London. You were working on your automaton and received a letter from Charles Babbage that ended up taking you to a library where you picked up a time travel device. Throughout your travels in time you've ended up in Florence, where you met Leonardo Da Vinci. You also went to the Aztec empire and this is where the story continues._
+>
+> See [Lesson 1](../01-intro-to-genai/README.md) if you want to catch up with the story from the beginning.
+
+> [!NOTE]
+> While we recommend going through the story (it's fun!), [click here](#interact-with-hypatia) if you'd prefer to jump straight to the technical content.
+
+TODO: returning to Ada's mansion, this time for a secret meeting and you start understanding what this is really about to guard time to ensure humanity makes it.. They do need to do the following next 1) retrieve important info from library in Alexandria 2) Recruit Hypatia 3) ensure Time Beetles can talk to each other, i.e use SSE
+
+
+
+
+
+