Merge pull request #149 from dgageot/add-openapi

Add openapi-schema and sync perplexity

Author: dgageot

prompts/catalog.yaml

@@ -143,6 +143,25 @@ registry:
       - name: slack.team_id
     prompts: 0
     resources: {}
+  openapi-schema:
+    description: OpenAPI Schema Model Context Protocol Server
+    ref: github:docker/labs-ai-tools-for-devs?ref=main&path=prompts/mcp/openapi-schema.md
+    readme: github:docker/labs-ai-tools-for-devs?ref=main&path=prompts/mcp/readmes/openapi-schema.md
+    source: https://github.com/slimslenderslacks/mcp-openapi-schema/tree/master
+    icon: https://avatars.githubusercontent.com/u/182288589?s=200&v=4
+    tools:
+      - name: get-component
+      - name: get-endpoint
+      - name: get-examples
+      - name: get-path-parameters
+      - name: get-request-body
+      - name: get-response-schema
+      - name: list-components
+      - name: list-endpoints
+      - name: list-security-schemes
+      - name: search-schema
+    prompts: 0
+    resources: {}
   redis:
     description: Access to Redis database operations.
     ref: github:docker/labs-ai-tools-for-devs?path=prompts/mcp/redis.md
@@ -448,14 +467,6 @@ registry:
       - name: notion.openai_mcp_headers
     prompts: 0
     resources: {}
-  openapi-schema:
-    description: |
-      Exposes OpenAPI schema information to Large Language Models (LLMs) like Claude. This server allows an LLM to explore and understand OpenAPI specifications through a set of specialized tools.
-    ref: github:docker/labs-ai-tools-for-devs?path=prompts/mcp/openapi-schema.md
-    icon: https://avatars.githubusercontent.com/u/182288589?s=200&v=4
-    tools: []
-    prompts: 0
-    resources: {}
   atlassian:
     description: Tools for Atlassian products (Confluence and Jira). This integration supports both Atlassian Cloud and Jira Server/Data Center deployments.
     ref: github:docker/labs-ai-tools-for-devs?ref=main&path=prompts/mcp/atlassian.md

prompts/mcp/openapi-schema.md

@@ -1,11 +1,10 @@
 ---
 mcp:
   - container:
-      image: vonwig/openapi-schema:latest
+      image: mcp/openapi-schema:latest
       workdir: /app
       volumes:
         - "{{openApiSchemaPath|or:[]|volume|into}}"
     source:
-      url: https://github.com/slimslenderslacks/mcp-openapi-schema/tree/main
+      url: https://github.com/slimslenderslacks/mcp-openapi-schema/tree/master
 ---
-

prompts/mcp/perplexity-ask.md

@@ -6,5 +6,5 @@ mcp:
       secrets:
         perplexity-ask.api_key: PERPLEXITY_API_KEY
     source:
-      url: https://github.com/ppl-ai/modelcontextprotocol/tree/main
+      url: https://github.com/ppl-ai/modelcontextprotocol/tree/f0a927c250e04b389ff5c34f6a2a85ad625668e8
 ---

prompts/mcp/readmes/openapi-schema.md

@@ -0,0 +1,141 @@
+# Openapi-schema MCP Server
+
+OpenAPI Schema Model Context Protocol Server
+
+[What is an MCP Server?](https://www.anthropic.com/news/model-context-protocol)
+
+## Characteristics
+Attribute|Details|
+|-|-|
+**Image Source**|Official Image
+|**Author**|[slimslenderslacks](https://github.com/slimslenderslacks)
+**Repository**|https://github.com/slimslenderslacks/mcp-openapi-schema
+**Dockerfile**|https://github.com/slimslenderslacks/mcp-openapi-schema/blob/master/Dockerfile
+**Docker Image built by**|Docker Inc.
+**Docker Scout Health Score**| ![Docker Scout Health Score](https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/openapi-schema)
+**Licence**|
+
+## Available Tools
+Tools provided by this Server|Short Description
+-|-
+`get-component`|Gets detailed definition for a specific component|
+`get-endpoint`|Gets detailed information about a specific API endpoint|
+`get-examples`|Gets examples for a specific component or endpoint|
+`get-path-parameters`|Gets the parameters for a specific path|
+`get-request-body`|Gets the request body schema for a specific endpoint|
+`get-response-schema`|Gets the response schema for a specific endpoint, method, and status code|
+`list-components`|Lists all schema components (schemas, parameters, responses, etc.)|
+`list-endpoints`|Lists all API paths and their HTTP methods with summaries, organized by path|
+`list-security-schemes`|Lists all available security schemes|
+`search-schema`|Searches across paths, operations, and schemas|
+
+---
+## Tools Details
+
+#### Tool: **`get-component`**
+Gets detailed definition for a specific component
+Parameters|Type|Description
+-|-|-
+`name`|`string`|Component name
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`type`|`string`|Component type (e.g., schemas, parameters, responses)
+
+---
+#### Tool: **`get-endpoint`**
+Gets detailed information about a specific API endpoint
+Parameters|Type|Description
+-|-|-
+`method`|`string`|
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`path`|`string`|
+
+---
+#### Tool: **`get-examples`**
+Gets examples for a specific component or endpoint
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`type`|`string`|Type of example to retrieve
+`componentName`|`string` *optional*|Component name (required for component examples)
+`componentType`|`string` *optional*|Component type (required for component examples)
+`method`|`string` *optional*|HTTP method (required for request/response examples)
+`path`|`string` *optional*|API path (required for request/response examples)
+`statusCode`|`string` *optional*|Status code (for response examples)
+
+---
+#### Tool: **`get-path-parameters`**
+Gets the parameters for a specific path
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`path`|`string`|
+`method`|`string` *optional*|
+
+---
+#### Tool: **`get-request-body`**
+Gets the request body schema for a specific endpoint
+Parameters|Type|Description
+-|-|-
+`method`|`string`|
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`path`|`string`|
+
+---
+#### Tool: **`get-response-schema`**
+Gets the response schema for a specific endpoint, method, and status code
+Parameters|Type|Description
+-|-|-
+`method`|`string`|
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`path`|`string`|
+`statusCode`|`string` *optional*|
+
+---
+#### Tool: **`list-components`**
+Lists all schema components (schemas, parameters, responses, etc.)
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+
+---
+#### Tool: **`list-endpoints`**
+Lists all API paths and their HTTP methods with summaries, organized by path
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+
+---
+#### Tool: **`list-security-schemes`**
+Lists all available security schemes
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+
+---
+#### Tool: **`search-schema`**
+Searches across paths, operations, and schemas
+Parameters|Type|Description
+-|-|-
+`openapiSchemaPath`|`string`|Path to the OpenAPI schema file
+`pattern`|`string`|Search pattern (case-insensitive)
+
+---
+## Use this MCP Server
+
+```json
+{
+  "mcpServers": {
+    "openapi-schema": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "mcp/openapi-schema"
+      ]
+    }
+  }
+}
+```
+
+[Why is it safer to run MCP Servers with Docker?](https://www.docker.com/blog/the-model-context-protocol-simplifying-building-ai-apps-with-anthropic-claude-desktop-and-docker/)

prompts/mcp/readmes/perplexity-ask.md

@@ -10,7 +10,7 @@ Attribute|Details|
 **Image Source**|Official Image
 |**Author**|[ppl-ai](https://github.com/ppl-ai)
 **Repository**|https://github.com/ppl-ai/modelcontextprotocol
-**Dockerfile**|https://github.com/ppl-ai/modelcontextprotocol/blob/main/perplexity-ask/Dockerfile
+**Dockerfile**|https://github.com/ppl-ai/modelcontextprotocol/blob/f0a927c250e04b389ff5c34f6a2a85ad625668e8/perplexity-ask/Dockerfile
 **Docker Image built by**|Docker Inc.
 **Docker Scout Health Score**| ![Docker Scout Health Score](https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/perplexity-ask)
 **Licence**|MIT License