feat: Typescript dog-facts MCP server that authenticates with OAuth

Author: clareliguori

.github/dependabot.yml

@@ -120,6 +120,16 @@ updates:
       prefix: "chore(deps)"
     rebase-strategy: "disabled"
 
+  - package-ecosystem: npm
+    directory: "/examples/servers/dog-facts"
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+    commit-message:
+      prefix: "chore(deps)"
+    rebase-strategy: "disabled"
+
   - package-ecosystem: npm
     directory: "/e2e_tests/typescript"
     schedule:

.github/workflows/cdk-checks.yml

@@ -195,3 +195,45 @@ jobs:
         working-directory: ./examples/servers/cat-facts
         env:
           CDK_DEFAULT_ACCOUNT: "000000000000"
+
+  check_dog_facts_server:
+    name: Check Typescript-based Dog Facts 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: Install CDK CLI
+        run: npm install -g aws-cdk
+
+      - name: Build and link local package
+        run: |
+          npm ci
+          npm audit --audit-level critical
+          npm run build
+          npm link
+        working-directory: ./src/typescript
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          npm audit --audit-level critical
+          npm link @aws/run-mcp-servers-with-aws-lambda
+        working-directory: ./examples/servers/dog-facts
+
+      - name: Build
+        run: npm run build
+        working-directory: ./examples/servers/dog-facts
+
+      - name: Synthesize CDK stack
+        run: cdk synth --app 'node lib/dog-facts-mcp-server.js'
+        working-directory: ./examples/servers/dog-facts
+        env:
+          CDK_DEFAULT_ACCOUNT: "000000000000"

.versionrc

@@ -50,6 +50,14 @@
       "filename": "examples/servers/cat-facts/package-lock.json",
       "type": "json"
     },
+    {
+      "filename": "examples/servers/dog-facts/package.json",
+      "type": "json"
+    },
+    {
+      "filename": "examples/servers/dog-facts/package-lock.json",
+      "type": "json"
+    },
     {
       "filename": "examples/chatbots/typescript/package.json",
       "type": "json"

DEVELOP.md

@@ -12,7 +12,8 @@ The example chatbot client will communicate with five servers:
 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 [local **fetch** MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch). Ask questions like "Who is Tom Cruise?".
+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?".
 
 ### Setup
 
@@ -150,6 +151,20 @@ npm run build
 cdk deploy --app 'node lib/cat-facts-mcp-server.js'
 ```
 
+Deploy the Lambda 'dog-facts' function - the deployed function will be named "mcp-server-dog-facts".
+
+```bash
+cd examples/servers/dog-facts/
+
+npm install
+
+npm link @aws/run-mcp-servers-with-aws-lambda
+
+npm run build
+
+cdk deploy --app 'node lib/dog-facts-mcp-server.js'
+```
+
 ### Run the example Python client
 
 Run the Python-based chatbot client:

e2e_tests/clean_up_integ_test.sh

@@ -23,3 +23,6 @@ cdk destroy --force --app 'node lib/weather-alerts-mcp-server.js'
 
 cd ../cat-facts/
 cdk destroy --force --app 'node lib/cat-facts-mcp-server.js'
+
+cd ../dog-facts/
+cdk destroy --force --app 'node lib/dog-facts-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 dog fact.",
         "Tell me a cat fact.",
         "Who is Tom Cruise?",
     ]

e2e_tests/run_integ_test.sh

@@ -41,6 +41,13 @@ npm link @aws/run-mcp-servers-with-aws-lambda
 npm run build
 cdk deploy --app 'node lib/cat-facts-mcp-server.js'
 
+# Deploy Typescript-based dog-facts MCP server
+cd ../dog-facts/
+npm ci
+npm link @aws/run-mcp-servers-with-aws-lambda
+npm run build
+cdk deploy --app 'node lib/dog-facts-mcp-server.js'
+
 # Configure integ tests
 cd ../../../e2e_tests/
 sed "s/INTEG_TEST_ID/$INTEG_TEST_ID/g" servers_config.integ.json > python/servers_config.json

e2e_tests/typescript/src/main.ts

@@ -34,6 +34,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 dog fact.",
     "Tell me a cat fact.",
     "Who is Tom Cruise?",
   ];

examples/chatbots/typescript/servers_config.json

@@ -14,5 +14,9 @@
       "functionName": "mcp-server-weather-alerts",
       "region": "us-east-2"
     }
+  },
+  "oAuthServers": {
+    "dog-facts": {
+      "serverStackName": "LambdaMcpServer-DogFacts"
   }
 }

examples/servers/cat-facts/README.md

@@ -12,10 +12,4 @@ $ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"
 
 # Get a random cat fact
 $ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"tools/call","params":{"name":"getRandomFact","arguments":{}},"jsonrpc":"2.0","id":0}, "")'
-
-# Get cat breeds
-$ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"tools/call","params":{"name":"getBreeds","arguments":{"limit":5}},"jsonrpc":"2.0","id":0}, "")'
-
-# Get multiple cat facts
-$ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"tools/call","params":{"name":"getFacts","arguments":{"limit":3,"max_length":100}},"jsonrpc":"2.0","id":0}, "")'
 ```