feat: Python function handlers for streamable HTTP

Plus, Python-based dad jokes MCP server that is authenticated with OAuth

Author: clareliguori

.github/dependabot.yml

@@ -70,6 +70,26 @@ updates:
       prefix: "chore(deps)"
     rebase-strategy: "disabled"
 
+  - package-ecosystem: pip
+    directory: "/examples/servers/dad-jokes"
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+    commit-message:
+      prefix: "chore(deps)"
+    rebase-strategy: "disabled"
+
+  - package-ecosystem: pip
+    directory: "/examples/servers/dad-jokes/function"
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+    commit-message:
+      prefix: "chore(deps)"
+    rebase-strategy: "disabled"
+
   - package-ecosystem: npm
     directory: "/src/typescript"
     schedule:

.github/workflows/cdk-checks.yml

@@ -76,6 +76,42 @@ jobs:
         env:
           CDK_DEFAULT_ACCOUNT: "000000000000"
 
+  check_dad_jokes_server:
+    name: Check Python-based Dad Jokes Server
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: "Set up Typescript"
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: "Set up Python"
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "src/python/.python-version"
+
+      - name: Install CDK CLI
+        run: npm install -g aws-cdk
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+        working-directory: ./examples/servers/dad-jokes
+
+      - uses: pypa/[email protected]
+        with:
+          inputs: ./examples/servers/dad-jokes/requirements.txt
+
+      - name: Synthesize CDK stack
+        run: cdk synth --app 'python3 cdk_stack.py'
+        working-directory: ./examples/servers/dad-jokes
+        env:
+          CDK_DEFAULT_ACCOUNT: "000000000000"
+
   check_auth_stack:
     name: Check Typescript-based Cognito stack
     runs-on: ubuntu-latest

DEVELOP.md

@@ -6,14 +6,15 @@ This guide will walk you through building the source code in this repository,
 deploying example MCP servers in Lambda functions,
 and using an example chatbot client to communicate with those Lambda-based MCP servers.
 
-The example chatbot client will communicate with five servers:
+The example chatbot client will communicate with seven servers:
 
 1. a Lambda function-based **time** MCP server (Python). Ask questions like "What is the current time?".
 2. a Lambda function-based **mcpdoc** MCP server (Python). Ask questions like "What documentation sources do you have access to?".
-3. a Lambda function-based **weather-alerts** MCP server (Typescript). Ask questions like "Are there any weather alerts right now?".
-4. a Lambda function-based **cat-facts** MCP server (Typescript). Ask questions like "Tell me something about cats".
-5. a Lambda function-based **dog-facts** MCP server (Typescript). Ask questions like "Tell me something about dogs".
-6. a [local **fetch** MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch). Ask questions like "Who is Tom Cruise?".
+3. a Lambda function-based **dad-jokes** MCP server (Python). Ask questions like "Tell me a good dad joke."
+4. a Lambda function-based **weather-alerts** MCP server (Typescript). Ask questions like "Are there any weather alerts right now?".
+5. a Lambda function-based **cat-facts** MCP server (Typescript). Ask questions like "Tell me something about cats".
+6. a Lambda function-based **dog-facts** MCP server (Typescript). Ask questions like "Tell me something about dogs".
+7. a [local **fetch** MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch). Ask questions like "Who is Tom Cruise?".
 
 ### Setup
 
@@ -121,6 +122,16 @@ uv pip install -r requirements.txt
 cdk deploy --app 'python3 cdk_stack.py'
 ```
 
+Deploy the Lambda 'dad-jokes' function - the deployed function will be named "mcp-server-dad-jokes".
+
+```bash
+cd examples/servers/dad-jokes/
+
+uv pip install -r requirements.txt
+
+cdk deploy --app 'python3 cdk_stack.py'
+```
+
 ### Deploy the example Typescript servers
 
 Deploy the Lambda 'weather-alerts' function - the deployed function will be named "mcp-server-weather-alerts".

e2e_tests/clean_up_integ_test.sh

@@ -18,6 +18,9 @@ cdk destroy --force --app 'python3 cdk_stack.py'
 cd ../mcpdoc
 cdk destroy --force --app 'python3 cdk_stack.py'
 
+cd ../dad-jokes
+cdk destroy --force --app 'python3 cdk_stack.py'
+
 cd ../weather-alerts/
 cdk destroy --force --app 'node lib/weather-alerts-mcp-server.js'
 

e2e_tests/python/main.py

@@ -89,6 +89,7 @@ async def main() -> None:
         "What is the current time in Seattle?",
         "Are there any weather alerts right now?",
         "List your available documentation sources.",
+        "Tell me a dad joke.",
         "Tell me a dog fact.",
         "Tell me a cat fact.",
         "Who is Tom Cruise?",

e2e_tests/run_integ_test.sh

@@ -22,6 +22,11 @@ cd ../mcpdoc
 uv pip install -r requirements.txt
 cdk deploy --app 'python3 cdk_stack.py' --require-approval never
 
+# Deploy Python-based Dad jokes MCP server
+cd ../dad-jokes
+uv pip install -r requirements.txt
+cdk deploy --app 'python3 cdk_stack.py' --require-approval never
+
 # Deploy Typescript-based example MCP server
 cd ../../../src/typescript/
 npm ci

e2e_tests/typescript/src/main.ts

@@ -47,6 +47,7 @@ async function main(): Promise<void> {
     "What is the current time in Seattle?",
     "Are there any weather alerts right now?",
     "List your available documentation sources.",
+    "Tell me a dad joke.",
     "Tell me a dog fact.",
     "Tell me a cat fact.",
     "Who is Tom Cruise?",

examples/servers/dad-jokes/README.md

@@ -0,0 +1,3 @@
+# Dad Jokes MCP Server
+
+This is an MCP (Model Context Protocol) server that provides access to dad jokes via the icanhazdadjoke.com API. It uses the mcp-openapi-proxy package to expose the API as MCP tools.