chore(deps): bump openapi-mcp-server from 1.2.0-beta05 to 2.0.3 in /examples/servers/cat-facts

.github/dependabot.yml

@@ -50,6 +50,26 @@ updates:
       prefix: "chore(deps)"
     rebase-strategy: "disabled"
 
+  - package-ecosystem: pip
+    directory: "/examples/servers/mcpdoc"
+    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/mcpdoc/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:
@@ -80,6 +100,16 @@ updates:
       prefix: "chore(deps)"
     rebase-strategy: "disabled"
 
+  - package-ecosystem: npm
+    directory: "/examples/servers/cat-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

@@ -40,6 +40,42 @@ jobs:
         env:
           CDK_DEFAULT_ACCOUNT: "000000000000"
 
+  check_mcpdoc_server:
+    name: Check Python-based MCP Doc 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/mcpdoc
+
+      - uses: pypa/gh-action-pip-audit@v1.1.0
+        with:
+          inputs: ./examples/servers/mcpdoc/requirements.txt
+
+      - name: Synthesize CDK stack
+        run: cdk synth --app 'python3 cdk_stack.py'
+        working-directory: ./examples/servers/mcpdoc
+        env:
+          CDK_DEFAULT_ACCOUNT: "000000000000"
+
   check_weather_alerts_server:
     name: Check Typescript-based Weather Alerts Server
     runs-on: ubuntu-latest
@@ -81,3 +117,45 @@ jobs:
         working-directory: ./examples/servers/weather-alerts
         env:
           CDK_DEFAULT_ACCOUNT: "000000000000"
+
+  check_cat_facts_server:
+    name: Check Typescript-based Cat 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/cat-facts
+
+      - name: Build
+        run: npm run build
+        working-directory: ./examples/servers/cat-facts
+
+      - name: Synthesize CDK stack
+        run: cdk synth --app 'node lib/cat-facts-mcp-server.js'
+        working-directory: ./examples/servers/cat-facts
+        env:
+          CDK_DEFAULT_ACCOUNT: "000000000000"

.mergify.yml

@@ -15,7 +15,9 @@ queue_rules:
       - status-success=Check Python library
       - status-success=Check Typescript library
       - status-success=Check Python-based Time Server
+      - status-success=Check Python-based MCP Doc Server
       - status-success=Check Typescript-based Weather Alerts Server
+      - status-success=Check Typescript-based Cat Facts Server
       - status-success=Check Typescript chatbot
     merge_method: squash
 

e2e_tests/clean_up_integ_test.sh

@@ -15,5 +15,11 @@ export INTEG_TEST_ID=$(cat e2e_tests/integ-test-id)
 cd examples/servers/time
 cdk destroy --force --app 'python3 cdk_stack.py'
 
+cd ../mcpdoc
+cdk destroy --force --app 'python3 cdk_stack.py'
+
 cd ../weather-alerts/
 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'

e2e_tests/python/main.py

@@ -79,6 +79,8 @@ async def main() -> None:
         "Hello!",
         "What is the current time in Seattle?",
         "Are there any weather alerts right now?",
+        "What documentation sources can you use to answer questions?",
+        "Tell me a cat fact.",
         "Who is Tom Cruise?",
     ]
     chat_session = ChatSession(servers, llm_client, user_utterances)

e2e_tests/run_integ_test.sh

@@ -17,6 +17,11 @@ cd ../../examples/servers/time
 uv pip install -r requirements.txt
 cdk deploy --app 'python3 cdk_stack.py'
 
+# Deploy Python-based mcpdoc MCP server
+cd ../mcpdoc
+uv pip install -r requirements.txt
+cdk deploy --app 'python3 cdk_stack.py'
+
 # Deploy Typescript-based example MCP server
 cd ../../../src/typescript/
 npm ci
@@ -29,6 +34,13 @@ npm link @aws/run-mcp-servers-with-aws-lambda
 npm run build
 cdk deploy --app 'node lib/weather-alerts-mcp-server.js'
 
+# Deploy Typescript-based cat-facts MCP server
+cd ../cat-facts/
+npm ci
+npm link @aws/run-mcp-servers-with-aws-lambda
+npm run build
+cdk deploy --app 'node lib/cat-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/servers_config.integ.json

@@ -13,6 +13,14 @@
     "weatherAlerts": {
       "functionName": "mcp-server-weather-alerts-INTEG_TEST_ID",
       "region": "us-east-2"
+    },
+    "mcpdoc": {
+      "functionName": "mcp-server-mcpdoc-INTEG_TEST_ID",
+      "region": "us-east-2"
+    },
+    "catFacts": {
+      "functionName": "mcp-server-cat-facts-INTEG_TEST_ID",
+      "region": "us-east-2"
     }
   }
 }

e2e_tests/typescript/src/main.ts

@@ -33,6 +33,8 @@ async function main(): Promise<void> {
     "Hello!",
     "What is the current time in Seattle?",
     "Are there any weather alerts right now?",
+    "What documentation sources can you use to answer questions?",
+    "Tell me a cat fact.",
     "Who is Tom Cruise?",
   ];
 

examples/chatbots/python/servers_config.json

@@ -13,6 +13,14 @@
     "weatherAlerts": {
       "functionName": "mcp-server-weather-alerts",
       "region": "us-east-2"
+    },
+    "mcpdoc": {
+      "functionName": "mcp-server-mcpdoc",
+      "region": "us-east-2"
+    },
+    "catFacts": {
+      "functionName": "mcp-server-cat-facts",
+      "region": "us-east-2"
     }
   }
 }

examples/chatbots/typescript/servers_config.json

@@ -13,6 +13,14 @@
     "weatherAlerts": {
       "functionName": "mcp-server-weather-alerts",
       "region": "us-east-2"
+    },
+    "mcpdoc": {
+      "functionName": "mcp-server-mcpdoc",
+      "region": "us-east-2"
+    },
+    "catFacts": {
+      "functionName": "mcp-server-cat-facts",
+      "region": "us-east-2"
     }
   }
 }

examples/servers/cat-facts/.npmignore

@@ -0,0 +1,6 @@
+*.ts
+!*.d.ts
+
+# CDK asset staging directory
+.cdk.staging
+cdk.out

examples/servers/cat-facts/README.md

@@ -0,0 +1,21 @@
+Sample inputs:
+
+```bash
+$ npm run build
+$ export LOG_LEVEL=debug
+
+# Initialize
+$ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"roots":{"listChanged":true}},"clientInfo":{"name":"mcp","version":"0.1.0"}},"jsonrpc":"2.0","id":0}, "")'
+
+# List tools
+$ node -e 'require("./lib/cat-facts-mcp-server.function.js").handler({"method":"tools/list","params":{"clientInfo":{"name":"mcp","version":"0.1.0"}},"jsonrpc":"2.0","id":0}, "")'
+
+# 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}, "")'
+```