feat: Switch from using quoterism API to zenquotes API

clareliguori · clareliguori · commit 7193eca2b874 · 2025-09-04T13:28:18.000-07:00
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -121,7 +121,7 @@ updates:
     rebase-strategy: "disabled"
 
   - package-ecosystem: pip
-    directory: "/examples/servers/inspiration"
+    directory: "/examples/servers/zen"
     schedule:
       interval: monthly
     open-pull-requests-limit: 10
diff --git a/.github/workflows/cdk-checks.yml b/.github/workflows/cdk-checks.yml
@@ -156,8 +156,8 @@ jobs:
         with:
           inputs: ./examples/servers/book-search/gateway_setup/requirements.txt
 
-  check_inspiration_server:
-    name: Check Python-based Inspiration Server
+  check_zen_server:
+    name: Check Python-based Zen Server
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -172,11 +172,11 @@ jobs:
 
       - name: Install gateway setup dependencies
         run: pip install -r requirements.txt
-        working-directory: ./examples/servers/inspiration
+        working-directory: ./examples/servers/zen
 
       - uses: pypa/gh-action-pip-audit@v1.1.0
         with:
-          inputs: ./examples/servers/inspiration/requirements.txt
+          inputs: ./examples/servers/zen/requirements.txt
 
   check_auth_stack:
     name: Check Typescript-based Cognito stack
diff --git a/DEVELOP.md b/DEVELOP.md
@@ -12,7 +12,7 @@ The example chatbot client will communicate with ten servers:
 2. **dog-facts**: Ask "Tell me something about dogs."
 3. **book-search**: Ask "Who wrote the book Pride and Prejudice?"
 4. **dictionary**: Ask "How do you pronounce the word 'onomatopoeia'?"
-5. **inspiration**: Ask "Tell me the inspirational quote of the day."
+5. **zen**: Ask "Tell me the inspirational quote of the day."
 6. **mcpdoc**: Ask "Summarize the first page of the Strands Agents documentation."
 7. **cat-facts**: Ask "Tell me something about cats."
 8. **time**: Ask "What is the current time?".
@@ -25,14 +25,14 @@ The example chatbot client will communicate with ten servers:
 | [dog-facts](/examples/servers/dog-facts/)           | Typescript | Lambda        | Streamable HTTP transport                           | OAuth          | API Gateway               |
 | [book-search](/examples/servers/book-search/)       | Python     | Lambda        | Streamable HTTP transport                           | OAuth          | Bedrock AgentCore Gateway |
 | [dictionary](/examples/servers/dictionary/)         | Typescript | Lambda        | Streamable HTTP transport                           | OAuth          | Bedrock AgentCore Gateway |
-| [inspiration](/examples/servers/inspiration/)       | N/A        | None          | Streamable HTTP transport                           | OAuth          | Bedrock AgentCore Gateway |
+| [zen](/examples/servers/zen/)                       | N/A        | None          | Streamable HTTP transport                           | OAuth          | Bedrock AgentCore Gateway |
 | [mcpdoc](/examples/servers/mcpdoc/)                 | Python     | Lambda        | Custom Streamable HTTP transport with SigV4 support | AWS IAM        | Lambda Function URL       |
 | [cat-facts](/examples/servers/cat-facts/)           | Typescript | Lambda        | Custom Streamable HTTP transport with SigV4 support | AWS IAM        | Lambda Function URL       |
 | [time](/examples/servers/time/)                     | Python     | Lambda        | Custom Lambda Invoke transport                      | AWS IAM        | Lambda Invoke API         |
 | [weather-alerts](/examples/servers/weather-alerts/) | Typescript | Lambda        | Custom Lambda Invoke transport                      | AWS IAM        | Lambda Invoke API         |
 | [fetch](https://pypi.org/project/mcp-server-fetch/) | Python     | Local process | stdio                                               | N/A            | N/A                       |
 
-Note: The 'inspiration' MCP server uses Bedrock AgentCore Gateway's built-in support for OpenAPI targets,
+Note: The 'zen' MCP server uses Bedrock AgentCore Gateway's built-in support for OpenAPI targets,
 so there is no Lambda function in that example.
 
 ### Setup
@@ -211,12 +211,12 @@ npm install
 npm run setup
 ```
 
-#### Deploy inspiration MCP server
+#### Deploy zen MCP server
 
-Deploy the 'inspiration' Bedrock AgentCore Gateway.
+Deploy the 'zen' Bedrock AgentCore Gateway.
 
 ```bash
-cd examples/servers/inspiration/
+cd examples/servers/zen/
 
 uv pip install -r requirements.txt
 
diff --git a/e2e_tests/clean_up_integ_test.sh b/e2e_tests/clean_up_integ_test.sh
@@ -27,7 +27,7 @@ cd gateway_setup/
 python teardown_gateway.py
 cd ../
 
-cd ../inspiration
+cd ../zen
 python teardown_gateway.py
 
 cd ../weather-alerts
diff --git a/e2e_tests/run_integ_test.sh b/e2e_tests/run_integ_test.sh
@@ -38,8 +38,8 @@ uv pip install -r requirements.txt
 python setup_gateway.py
 cd ../
 
-# Deploy Python-based inspiration MCP server
-cd ../inspiration
+# Deploy Python-based zen MCP server
+cd ../zen
 uv pip install -r requirements.txt
 python setup_gateway.py
 
diff --git a/e2e_tests/servers_config.integ.json b/e2e_tests/servers_config.integ.json
@@ -30,8 +30,8 @@
     "dad-jokes": {
       "serverStackName": "LambdaMcpServer-DadJokes-INTEG_TEST_ID"
     },
-    "inspiration": {
-      "serverSsmParameterName": "LambdaMcpServer-Inspiration-Gateway-INTEG_TEST_ID",
+    "zen": {
+      "serverSsmParameterName": "LambdaMcpServer-Zen-Gateway-INTEG_TEST_ID",
       "serverSsmRegion": "us-west-2"
     },
     "bookSearch": {
diff --git a/examples/chatbots/python/servers_config.json b/examples/chatbots/python/servers_config.json
@@ -30,8 +30,8 @@
     "dad-jokes": {
       "serverStackName": "LambdaMcpServer-DadJokes"
     },
-    "inspiration": {
-      "serverSsmParameterName": "LambdaMcpServer-Inspiration-Gateway",
+    "zen": {
+      "serverSsmParameterName": "LambdaMcpServer-Zen-Gateway",
       "serverSsmRegion": "us-west-2"
     },
     "bookSearch": {
diff --git a/examples/chatbots/typescript/servers_config.json b/examples/chatbots/typescript/servers_config.json
@@ -30,8 +30,8 @@
     "dad-jokes": {
       "serverStackName": "LambdaMcpServer-DadJokes"
     },
-    "inspiration": {
-      "serverSsmParameterName": "LambdaMcpServer-Inspiration-Gateway",
+    "zen": {
+      "serverSsmParameterName": "LambdaMcpServer-Zen-Gateway",
       "serverSsmRegion": "us-west-2"
     },
     "bookSearch": {
diff --git a/examples/servers/auth/lib/mcp-auth.ts b/examples/servers/auth/lib/mcp-auth.ts
@@ -96,7 +96,7 @@ export class McpAuthStack extends cdk.Stack {
       "dog-facts",
       "book-search",
       "dictionary",
-      "inspiration",
+      "zen",
     ];
     const resourceServerScopes = mcpServers.map(
       (mcpServer) =>
diff --git a/examples/servers/inspiration/quoterism-openapi.json b/examples/servers/inspiration/quoterism-openapi.json
diff --git a/examples/servers/zen/README.md b/examples/servers/zen/README.md
@@ -1,8 +1,8 @@
-# Inspiration Remote MCP Server
+# Zen Remote MCP Server
 
 This remote MCP server uses Bedrock AgentCore Gateway's built-in support for OpenAPI targets.
 The gateway is configured with a simplified OpenAPI
-specification for the [Quoterism](https://www.quoterism.com/developer) API.
+specification for the [ZenQuotes](https://zenquotes.io/) API.
 
 - Language: N/A
 - Transport: Streamable HTTP transport
diff --git a/examples/servers/zen/requirements.txt b/examples/servers/zen/requirements.txt
diff --git a/examples/servers/zen/setup_gateway.py b/examples/servers/zen/setup_gateway.py
@@ -16,7 +16,7 @@ def main():
     account_id = sts.get_caller_identity()["Account"]
 
     # Load OpenAPI schema
-    with open("quoterism-openapi.json", "r") as f:
+    with open("zenquotes-openapi.json", "r") as f:
         openapi_schema = json.load(f)
 
     # Get Cognito authorizer info from CloudFormation stack
@@ -54,7 +54,7 @@ def main():
     # Create Gateway
     role_arn = f"arn:aws:iam::{account_id}:role/mcp-lambda-example-agentcore-gateways"
 
-    gateway_name = f"LambdaMcpServer-Inspiration-Gateway{suffix}"
+    gateway_name = f"LambdaMcpServer-Zen-Gateway{suffix}"
     if len(gateway_name) > 50:
         gateway_name = gateway_name[:50].rstrip('-')
 
@@ -74,7 +74,7 @@ def main():
     }
 
     ssm_client.put_parameter(
-        Name=f"LambdaMcpServer-Inspiration-Gateway{suffix}",
+        Name=f"LambdaMcpServer-Zen-Gateway{suffix}",
         Value=json.dumps(gateway_info),
         Type="String",
         Overwrite=True,
@@ -83,7 +83,7 @@ def main():
     # Create OpenAPI target
     gateway_client.create_mcp_gateway_target(
         gateway=gateway,
-        name="quoterism-target",
+        name="zenquotes-target",
         target_type="openApiSchema",
         target_payload={"inlinePayload": json.dumps(openapi_schema)},
         # Target API does not require authentication, but Gateway requires credentials be provided.
@@ -98,7 +98,7 @@ def main():
     print(f"Gateway created successfully:")
     print(f"  ID: {gateway['gatewayId']}")
     print(f"  URL: {gateway['gatewayUrl']}")
-    print(f"  Saved to SSM parameter: LambdaMcpServer-Inspiration-Gateway{suffix}")
+    print(f"  Saved to SSM parameter: LambdaMcpServer-Zen-Gateway{suffix}")
 
 
 if __name__ == "__main__":
diff --git a/examples/servers/zen/teardown_gateway.py b/examples/servers/zen/teardown_gateway.py
@@ -15,7 +15,7 @@ def main():
 
     try:
         response = ssm_client.get_parameter(
-            Name=f"LambdaMcpServer-Inspiration-Gateway{suffix}"
+            Name=f"LambdaMcpServer-Zen-Gateway{suffix}"
         )
         gateway_info = json.loads(response["Parameter"]["Value"])
         gateway_id = gateway_info["gatewayId"]
@@ -45,7 +45,7 @@ def main():
     agentcore_client.delete_gateway(gatewayIdentifier=gateway_id)
 
     # Delete SSM parameter
-    ssm_client.delete_parameter(Name=f"LambdaMcpServer-Inspiration-Gateway{suffix}")
+    ssm_client.delete_parameter(Name=f"LambdaMcpServer-Zen-Gateway{suffix}")
 
     print(f"Gateway {gateway_id} deleted successfully")
 
diff --git a/examples/servers/zen/zenquotes-openapi.json b/examples/servers/zen/zenquotes-openapi.json
@@ -0,0 +1,53 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "ZenQuotes API",
+    "version": "1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://zenquotes.io"
+    }
+  ],
+  "paths": {
+    "/api/today": {
+      "get": {
+        "operationId": "getTodayQuote",
+        "summary": "Get today's featured quote",
+        "responses": {
+          "200": {
+            "description": "Today's quote",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "q": {
+                        "type": "string",
+                        "description": "Quote text"
+                      },
+                      "a": {
+                        "type": "string",
+                        "description": "Author name"
+                      },
+                      "c": {
+                        "type": "string",
+                        "description": "Character count"
+                      },
+                      "h": {
+                        "type": "string",
+                        "description": "Pre-formatted HTML quote"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/pipeline/src/pipeline-stack.ts b/pipeline/src/pipeline-stack.ts
@@ -264,9 +264,9 @@ export class McpServersPipelineStack extends cdk.Stack {
       });
     });
 
-    // Add inspiration server with custom deployment
-    builds["inspiration"] = new codebuild.Project(this, "inspirationBuild", {
-      projectName: "mcp-server-inspiration-deploy",
+    // Add zen server with custom deployment
+    builds["zen"] = new codebuild.Project(this, "zenBuild", {
+      projectName: "mcp-server-zen-deploy",
       role: codeBuildRole,
       environment: {
         buildImage: codebuild.LinuxBuildImage.STANDARD_7_0,
@@ -283,7 +283,7 @@ export class McpServersPipelineStack extends cdk.Stack {
           },
           build: {
             commands: [
-              "cd examples/servers/inspiration",
+              "cd examples/servers/zen",
               "uv venv",
               ". .venv/bin/activate",
               "uv pip install -r requirements.txt",
@@ -388,11 +388,11 @@ export class McpServersPipelineStack extends cdk.Stack {
       });
     });
 
-    // Add inspiration server deployment action
+    // Add zen server deployment action
     actions.push(
       new codepipeline_actions.CodeBuildAction({
-        actionName: "DeployInspiration",
-        project: serverBuilds["inspiration"],
+        actionName: "DeployZen",
+        project: serverBuilds["zen"],
         input: sourceOutput,
         runOrder: 1,
       })
