From 8a75e09ad02d36f5c96d43633c950886b08d9606 Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 11:59:40 -0400 Subject: [PATCH 1/7] docs: update usage, architecture, maintenance * contributing, node maintenance schedule * architecture, recent adds for features and planning * development, minor adds for node maintenance, future work * usage, add recent adds, refactors for tools, resources --- CONTRIBUTING.md | 29 +++++++++++--- README.md | 2 +- docs/README.md | 6 +-- docs/architecture.md | 92 +++++++++++++++++++++++++------------------- docs/development.md | 52 ++++++++++++++++--------- docs/usage.md | 32 +++++++++++---- 6 files changed, 138 insertions(+), 75 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7577346b..38dc214e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -59,7 +59,7 @@ Development pull requests (PRs) should be opened against the default branch. > If your pull request work contains any of the following warning signs > - has no related issue > - ignores existing code style -> - out of sync commits (not rebased against the default branch) +> - out-of-sync commits (not rebased against the default branch) > - poorly structured commits and messages > - any one commit relies on other commits to work (beyond "review requested updates") > - dramatic file restructures that attempt complex behavior @@ -116,7 +116,7 @@ Basic code style guidelines are generally enforced by ESLint, but there are addi - Tests should focus on functionality. - Tests should not be written for external packages. That is the responsibility of the external package, or it shouldn't be used. -#### Typescript +#### TypeScript - Typings within the project may be generally loose for initial development but should be refined over time. - Typings exposed to consumers should always attempt to maintain consistency. - Typings for tests are less of a focus than functionality checks. @@ -142,9 +142,28 @@ npm run test:integration This mode leverages the `--mode test` and `--mode-test-url` flags to redirect resource lookups to a fixture server instead of live or local resources. +## Maintenance: Node.js engine bumps + +The `Node.js` engine requirements are updated on a predictable biannual schedule to ensure the server remains secure, leverages modern runtime features, and provides stability for consumers. + +> Our engine requirements are intended to be the minimum to run the MCP server. They are not intended to be a maximum, as newer versions may introduce breaking changes or require additional configuration. + +### Schedule and process +- **Timing**: Bumps are generally targeted for **Spring (April/May)** and **Fall (October/November)**, aligned with the [Node.js release schedule](https://nodejs.org/en/about/previous-releases) as versions enter or exit LTS. +- **Security**: Out-of-band updates may be performed if critical security considerations arise. +- **Version Targets**: + - Focus on the latest **even-numbered (LTS/Stable)** versions (e.g., bumping to 22, 24, or 26). + - GitHub Workflows should be updated to include the latest available even version. + +### Acceptance criteria for bumps +- Update `package.json` engine requirements. +- Update related GitHub Action workflows (CI/CD). +- Update "Environmental Requirements" in documentation. +- Ensure all tests pass on the new target version. + ## AI agent -### User Section +### User section Current agent interaction can be triggered with the chat command @@ -157,12 +176,12 @@ For detailed information on agent interaction, see [guidelines/README.md](./guid As developers, we often have our own preferred workflows, and that includes working with AI agents. To that point, we've added agent guidance to allow customization for your work environment through a tool-agnostic git-ignored directory `./.agent` in the root of the project. -#### Noting AI Agent contributions +#### Noting AI agent contributions Please reference [PatternFly's AI-assisted development guidelines](https://github.com/patternfly/.github/blob/main/CONTRIBUTING.md) for guidance on how to acknowledge AI agent contributions. -### Agent Only +### Agent only Agents: This repository contains a hierarchical guideline system. Agents should review agent-only comment blocks. F1A - F1B(["Built-In resources"]) + F1B <--> F1A + F1B(["Built-In resources & discovery layer"]) end end D1(["Server proxy"]) + D1 <--> F1 + subgraph G1["Child process host"] + G1A(["Tools host & isolation sandbox"]) + end + D1 <--> G1 end - B1(["Local external tools, prompts, resources"]) + B1(["Local and remote external tools, prompts, resources"]) B1 <--> D1 ``` @@ -67,19 +70,19 @@ flowchart TD ### Planned features and integrations -To get towards our future state, there are a series of planned features and integrations. +Our roadmap focuses on expanding the server's reach and providing a more integrated development experience. -Current focus: -- **YAML configuration for remote tools, resources and prompts** - YAML configuration for remote MCP tools, resources, and prompt plugins -- **MCP resource, prompts, and helper function sharing** - A way to share MCP resources, prompts, and helper functions towards external tool plugins. -- **Find PatternFly documentation tool** - A tool that reaches out to known PatternFly documentation sources, caches locally, and integrates the results with existing MCP tools and resources. -- **PatternFly API integration** - A JSON API for PatternFly documentation, components, and patterns. -- **Hosted resource for sharing MCP tools, resources, prompts** - Shared tooling customization through PatternFly AI tooling repository (or equivalent) +#### In-progress +- **Hybrid documentation model**: A JSON API for documentation, components, and patterns that ensures the server is always in sync with the latest releases. + - **PatternFly API Integration**: Embedded integration into the server for standalone purposes, quick starts, and immediate access. + - **Child Process Lifecycle Management**: Background process while you work for API synchronization. -Under consideration: -- **MCP client** - A tailored MCP client specific for the PatternFly MCP server. -- **Auditing for shared tools, resources, and prompts** - An auditing tool that helps you refine your shared tools, resources, and prompts. -- **Containerized PatternFly MCP server, client, and LLM** - A containerized PatternFly MCP server, client, and embedded LLM. Use your own PatternFly chat client resource. +#### In-planning and under review +- **Resource-Tool Integration**: Directly integrate MCP resources into tool responses to reduce token counts and allow tools to accept URI links as inputs. +- **Environment & Analysis Tooling**: A third built-in tool focused on environment snapshots, code analysis, and whitelisted resource access for local project analysis. +- **Agentless MCP Client**: An MCP client for use without an LLM, allowing PatternFly tooling to integrate into CLI tools and CI/CD pipelines. +- **YAML Configuration**: Remote tool, resource, and prompt plugins configured via YAML. +- **Resource/Helper Sharing**: Mechanisms to share resources and helper functions across external tool plugins. #### Future state @@ -87,21 +90,30 @@ Under consideration: flowchart TD subgraph A1["MCP server"] subgraph E1["Session context"] - subgraph F1["Logging, stats context"] + subgraph F1["Logging, Resource discovery context"] F1C(["Built-In prompts"]) F1C <--> F1A subgraph F1A["Built-In tools"] - F1AA(["Search PF docs"]) - F1AB(["Use PF docs"]) - F1AC(["Find PF docs"]) + F1AA(["Search PatternFly docs"]) + F1AB(["Use PatternFly docs"]) + F1AC(["Analyze environment"]) end F1B <--> F1A - F1B(["Built-In resources"]) + F1B(["Built-In resources & discovery layer"]) end end - F1B --> D1 D1(["Server proxy"]) + D1 <--> F1 + subgraph G1["Child process host"] + G1A(["Tools host & isolation sandbox"]) + G1B(["API synchronization process"]) + end + D1 <--> G1 + end + subgraph H1["Agentless client layer"] + H1A(["CLI & Automation integration"]) end + A1 <--> H1 B1(["Local and remote external tools, prompts, resources"]) B1 <--> D1 ``` diff --git a/docs/development.md b/docs/development.md index ddaadb0f..960153b9 100644 --- a/docs/development.md +++ b/docs/development.md @@ -3,12 +3,14 @@ Complete guide to using the PatternFly MCP Server for development including CLI and programmatic API usage. **Development:** -- [CLI Usage](#cli-usage) -- [Programmatic Usage](#programmatic-usage) -- [Tool Plugins](#tool-plugins) -- [Initial Troubleshooting](#initial-troubleshooting) +- [CLI usage](#cli-usage) +- [Programmatic usage](#programmatic-usage) +- [MCP tool plugins](#mcp-tool-plugins) +- [Initial troubleshooting](#initial-troubleshooting) +- [Project maintenance](#project-maintenance) +- [In-progress and future work](#in-progress-and-future-work) -## CLI Usage +## CLI usage ### Available options @@ -31,8 +33,8 @@ Complete guide to using the PatternFly MCP Server for development including CLI #### Notes - **HTTP transport mode** - By default, the server uses `stdio`. Use the `--http` flag to enable HTTP transport. - **Logging** - The server uses a `diagnostics_channel`-based logger that keeps STDIO stdout pure by default. -- **Programmatic API** - The server can also be used programmatically with options. See [Programmatic Usage](#programmatic-usage) for more details. -- **Tool Plugins** - The server can load external tool plugins at startup. See [Tool Plugins](#tool-plugins) for more details. +- **Programmatic API** - The server can also be used programmatically with options. See [Programmatic usage](#programmatic-usage) for more details. +- **Tool plugins** - The server can load external tool plugins at startup. See [MCP tool plugins](#mcp-tool-plugins) for more details. - **Test Mode** - When `--mode test` is used, the server redirects resource requests to the URL provided by `--mode-test-url`, enabling E2E testing without local filesystem access. ### Basic use scenarios @@ -128,6 +130,11 @@ const server: PfMcpInstance = await start(options); The documentation catalog `src/docs.json` pins remote resources to specific commit SHAs (or explicit refs) for stability and reproducibility. This avoids unexpected upstream changes from breaking results. The `searchPatternFlyDocs` tool handles these lookups transparently for the user. +#### Programmatic runtime requirements + +- **Node.js 20+**: Required to run the core MCP server. +- **Node.js 22+**: Required for loading external tool plugins (`--tool`) and for developers working on advanced process isolation features. + **Example: Programmatic test mode** ```typescript import { start, type PfMcpInstance } from '@patternfly/patternfly-mcp'; @@ -220,7 +227,7 @@ const logSubscription = subscribe(logChannel, logHandler); Reference typings are exported from the package. The full listing can be found in [src/index.ts](../src/index.ts). -### Embedding the Server +### Embedding the server You can embed the MCP server inside your application using the `start()` function and provide **Tool Modules** directly. @@ -267,17 +274,17 @@ main(); See [examples/](examples/) for more programmatic usage examples. -## MCP Tool Plugins +## MCP tool plugins You can extend the server's capabilities by loading **Tool Plugins** at startup. These plugins run out‑of‑process in an isolated **Tools Host** to ensure security and stability. -### Environmental Requirements +### Tool plugin runtime requirements - **Node.js >= 22**: Loading external tool plugins (`--tool`) requires Node.js version 22 or higher due to the use of advanced process isolation and ESM module loading features. - **ESM**: Plugins MUST be authored as ECMAScript Modules. - **Dependency Resolution**: Plugins importing from `@patternfly/patternfly-mcp` require the package to be resolvable in the execution environment. This may require a local `npm install` in the plugin's directory or project root if the package is not available globally. -### Security & Isolation +### Security & isolation The server provides two isolation modes for external plugins via the `--plugin-isolation` flag: @@ -293,11 +300,11 @@ The server provides two isolation modes for external plugins via the `--plugin-i - **`Tool Factory`**: A function wrapper `(options) => Tool` (internal). - **`Tool Module`**: The programmatic result of `createMcpTool`, representing a collection of tools. -### Authoring Tools +### Authoring tools We recommend using the `createMcpTool` helper to define tools. It ensures your tools are properly normalized for the server. -#### Authoring a single Tool Module +#### Authoring a single tool module ```ts import { createMcpTool } from '@patternfly/patternfly-mcp'; @@ -329,7 +336,7 @@ export default createMcpTool([ ]); ``` -#### Input Schema Format +#### Input schema format The `inputSchema` property accepts either **plain JSON Schema objects** or **Zod schemas**. Both formats are automatically converted to the format required by the MCP SDK. @@ -357,24 +364,31 @@ const inputSchema = z.object({ See [examples/toolPluginHelloWorld.js](examples/toolPluginHelloWorld.js) for a basic example. -## Initial Troubleshooting +## Initial troubleshooting -### Tool Plugins +### Tool plugins - **Plugins don't appear**: Verify the Node version (requires Node.js >= 20; >= 22 for tool plugins) and check logs (enable `--log-stderr`). - **Startup warnings/errors**: Startup `load:ack` warnings/errors from tool plugins are logged when stderr/protocol logging is enabled. -- **Schema errors**: If `tools/call` rejects with schema errors, ensure `inputSchema` is valid. See [Authoring Tools](#authoring-tools) for details. +- **Schema errors**: If `tools/call` rejects with schema errors, ensure `inputSchema` is valid. See [Authoring tools](#authoring-tools) for details. - **Network access issues**: If the tool is having network access issues, you may need to configure `--plugin-isolation none`. This is generally discouraged for security reasons but may be necessary in some cases. -### HTTP Transport +### HTTP transport - **Connection issues**: Ensure the port is not already in use and the host is correct. - **CORS errors**: Configure `--allowed-origins` if accessing from a web client. - **DNS rebinding protection**: If behind a proxy, ensure correct `Host` header and configure `--allowed-hosts`. -### General Issues +### General issues - **Server won't start**: Check Node.js version (requires Node.js >= 20; >= 22 for tool plugins). - **Missing tools/resources**: Verify the server started successfully and check logs with `--log-stderr`. - **Type errors**: Ensure TypeScript types are installed: `npm install --save-dev @types/node` +## Project maintenance + +For information on how we manage project dependencies, including our biannual Node.js engine bump schedule, please refer to the [Maintenance section in CONTRIBUTING.md](../CONTRIBUTING.md#maintenance-nodejs-engine-bumps). + +## In-progress and future work + +For more information on our development roadmap, including "in-progress" and "future" work, please refer to the [Architecture & Roadmap](./architecture.md#roadmap) documentation. diff --git a/docs/usage.md b/docs/usage.md index 27bd13e9..d7e0cb49 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -62,15 +62,33 @@ Fetch full documentation and component JSON schemas for specific PatternFly URLs ## Built-in resources -> MCP resources represent indexed collections of documentation. +> MCP resources represent indexed collections of documentation and machine-readable metadata. -The server exposes this resource-centric architecture via the `patternfly://` URI scheme: +The server exposes a resource-centric architecture via the `patternfly://` URI scheme. MCP clients can use these resources directly. [Review the roadmap for future resource updates](./architecture.md#roadmap). -- **`patternfly://context`**: General PatternFly MCP server context and high-level rules. -- **`patternfly://docs/index`**: Index of all available documentation pages. -- **`patternfly://docs/{name}`**: Documentation for a specific component (e.g., `patternfly://docs/Button`). -- **`patternfly://schemas/index`**: Index of all available component schemas. -- **`patternfly://schemas/{name}`**: JSON Schema for a specific component (e.g., `patternfly://schemas/Button`). +### Discovery resources + +Use these indexes to discover what is available in the library: + +- **`patternfly://docs/index{?version,category,section}`**: A comprehensive index of all available PatternFly documentation pages. +- **`patternfly://docs/meta{?version}`**: Metadata discovery for available PatternFly documentation pages, helpful for understanding available filter parameters. +- **`patternfly://components/index{?version,category}`**: A list of all available PatternFly component names. +- **`patternfly://components/meta{?version}`**: Metadata discovery for components, helpful for understanding available filter parameters. +- **`patternfly://schemas/index{?version,category}`**: An index of all available component JSON schemas. +- **`patternfly://schemas/meta{?version}`**: Metadata discovery for JSON schemas, helpful for understanding available filter parameters. + +### Component and documentation resources + +Access specific component documentation or technical specifications using the following URI templates (RFC 6570): + +- **`patternfly://docs/{name}{?version,category,section}`**: Full human-readable documentation for a specific component (e.g., `patternfly://docs/button`) or guideline. +- **`patternfly://schemas/{name}{?version,category}`**: Machine-readable JSON Schema for a specific component, detailing props, types, and validation rules (e.g., `patternfly://schemas/button`). + +### Context and guidelines + +- **`patternfly://context`**: General PatternFly MCP server context, including high-level development rules and accessibility guidelines. + +> **Tip for LLMs**: When a user asks about a component you aren't familiar with, first check `patternfly://docs/index` to find the correct name, then read the documentation via `patternfly://docs/{name}`. Use `patternfly://components/index` for a cleaner list of component-only names. ## MCP client configuration From ec2af13a1e18f837e4fe558238ae5cd40157c78e Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 15:27:31 -0400 Subject: [PATCH 2/7] fix: review update --- docs/architecture.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index 3b7569a6..7cc0c91c 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -25,8 +25,8 @@ Instead of a standalone "discovery" tool, the server implements a robust **Resou #### Hybrid documentation model (in-progress) We'll be introducing our hybrid documentation model in upcoming releases. This concept balances stability and currentness by integrating core guidelines and standards directly into the server while syncing from the latest available PatternFly implementation. -- **Baseline Data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access. -- **Dynamic Content**: Content synced from the latest available PatternFly implementation while you work, ensuring the LLM always has access to the latest documentation and patterns. +- **Baseline data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access. +- **Dynamic content**: Content synced from the latest available PatternFly implementation while you work, ensuring the LLM always has access to the latest documentation and patterns. ### Tools, resources, and prompts as customizable plugins From 236e946fdacf2b8f1537dff53dc57f5bad642022 Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 15:39:18 -0400 Subject: [PATCH 3/7] fix: review add --- README.md | 4 ++++ docs/architecture.md | 12 ++++++++++++ docs/usage.md | 2 ++ 3 files changed, 18 insertions(+) diff --git a/README.md b/README.md index dd7f885d..68ec69cf 100644 --- a/README.md +++ b/README.md @@ -94,6 +94,10 @@ main(); For comprehensive usage, development, and project state [read the docs](./docs/README.md). +- **Architecture**: Learn about our [hybrid documentation model and data sources](./docs/architecture.md#data-sources-and-integrations). +- **Usage**: Detailed guide on [built-in tools and resources](./docs/usage.md). +- **Development**: Reference for [CLI options and tool plugins](./docs/development.md). + ## Contributing Contributing? Guidelines can be found here [CONTRIBUTING.md](./CONTRIBUTING.md). diff --git a/docs/architecture.md b/docs/architecture.md index 7cc0c91c..a5b6e6af 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -28,6 +28,18 @@ We'll be introducing our hybrid documentation model in upcoming releases. This c - **Baseline data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access. - **Dynamic content**: Content synced from the latest available PatternFly implementation while you work, ensuring the LLM always has access to the latest documentation and patterns. +### Data sources and integrations + +The PatternFly MCP server aggregates content from multiple official sources to provide a comprehensive development resource. + +#### PatternFly ai-helpers +The server integrates the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) repository to provide specialized, LLM-optimized guidance. This integration powers several key resource categories: +- **AI Guidance**: Specialized patterns for React Charts, Chatbot, and general React development. +- **Styling Standards**: CSS and styling requirements tailored for AI code generation. +- **Prompt Engineering**: Includes `ai-prompt-guidance.md` to help users write more effective prompts for PatternFly. + +These helpers are a core part of our [Hybrid documentation model](#hybrid-documentation-model-in-progress), acting as the bridge between stable design patterns and dynamic implementation details. + ### Tools, resources, and prompts as customizable plugins Tools, resources, and prompts as customizable plugins are the result of predictable MCP SDK patterns. In the case of the PatternFly MCP server, diff --git a/docs/usage.md b/docs/usage.md index d7e0cb49..3ee71eba 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -66,6 +66,8 @@ Fetch full documentation and component JSON schemas for specific PatternFly URLs The server exposes a resource-centric architecture via the `patternfly://` URI scheme. MCP clients can use these resources directly. [Review the roadmap for future resource updates](./architecture.md#roadmap). +> **Note on AI Content**: Specialized resources such as `patternfly://docs/react-guidelines` and `patternfly://docs/ai-prompt-guidance` are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations). + ### Discovery resources Use these indexes to discover what is available in the library: From db6bb4952f1db8803ea8c913eb40ae9564547a4b Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 15:47:31 -0400 Subject: [PATCH 4/7] fix: review update --- docs/usage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/usage.md b/docs/usage.md index 3ee71eba..7bee5884 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -66,7 +66,7 @@ Fetch full documentation and component JSON schemas for specific PatternFly URLs The server exposes a resource-centric architecture via the `patternfly://` URI scheme. MCP clients can use these resources directly. [Review the roadmap for future resource updates](./architecture.md#roadmap). -> **Note on AI Content**: Specialized resources such as `patternfly://docs/react-guidelines` and `patternfly://docs/ai-prompt-guidance` are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations). +> **Note on AI Content**: Specialized AI guidance resources are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations). ### Discovery resources From 6b1b3451f821fe80c173cc44808b569678dd8983 Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 16:22:17 -0400 Subject: [PATCH 5/7] fix: review update --- docs/architecture.md | 6 ++++-- docs/usage.md | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index a5b6e6af..9a2a7ae6 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -6,12 +6,14 @@ The PatternFly MCP server is centered around the concept of a library for all th ### The library, PatternFly integration -The current PatternFly MCP server provides a hybrid documentation system that will merge baseline guidelines with dynamic content. It is centered around a **Resource Metadata** discovery layer that powers the following core concepts: +The current PatternFly MCP server is centered on a **Resource Metadata** discovery layer that enables the following core concepts: - **Searching for resources**: Querying the library for relevant documentation and components. - **Reading resources**: Accessing full documentation and machine-readable schemas. - **Discovering resources**: Navigating the library via resource indexes and URI templates. +> [A more in-depth version of our **hybrid documentation model** concept is currently in progress](#hybrid-documentation-model-in-progress). + #### Discovery layer (resource metadata) Instead of a standalone "discovery" tool, the server implements a robust **Resource Metadata system**. This system: @@ -24,7 +26,7 @@ Instead of a standalone "discovery" tool, the server implements a robust **Resou #### Hybrid documentation model (in-progress) -We'll be introducing our hybrid documentation model in upcoming releases. This concept balances stability and currentness by integrating core guidelines and standards directly into the server while syncing from the latest available PatternFly implementation. +We'll be introducing more updates based on our hybrid documentation concept in upcoming releases. The base concept balances stability and currentness by integrating core guidelines and standards directly into the server while syncing from the latest available PatternFly implementation. - **Baseline data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access. - **Dynamic content**: Content synced from the latest available PatternFly implementation while you work, ensuring the LLM always has access to the latest documentation and patterns. diff --git a/docs/usage.md b/docs/usage.md index 7bee5884..4f672e79 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -66,7 +66,7 @@ Fetch full documentation and component JSON schemas for specific PatternFly URLs The server exposes a resource-centric architecture via the `patternfly://` URI scheme. MCP clients can use these resources directly. [Review the roadmap for future resource updates](./architecture.md#roadmap). -> **Note on AI Content**: Specialized AI guidance resources are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations). +> **Note on AI content**: Specialized AI guidance resources are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations). ### Discovery resources From 61552ee1be6f9b351f0a5b33f62b5cdd38745f50 Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 16:28:07 -0400 Subject: [PATCH 6/7] fix: review update --- docs/architecture.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index 9a2a7ae6..0ef2640b 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -12,7 +12,7 @@ The current PatternFly MCP server is centered on a **Resource Metadata** discove - **Reading resources**: Accessing full documentation and machine-readable schemas. - **Discovering resources**: Navigating the library via resource indexes and URI templates. -> [A more in-depth version of our **hybrid documentation model** concept is currently in progress](#hybrid-documentation-model-in-progress). +> [A more in-depth version of our **hybrid documentation** concept is currently in progress](#hybrid-documentation-in-progress). #### Discovery layer (resource metadata) @@ -24,7 +24,7 @@ Instead of a standalone "discovery" tool, the server implements a robust **Resou > This discovery layer treats the MCP server as a living library. It enables the server to provide updates for all built-in tools and resources while maintaining a tailored experience based on user patterns (e.g., tailoring responses for designers vs. developers). -#### Hybrid documentation model (in-progress) +#### Hybrid documentation (in-progress) We'll be introducing more updates based on our hybrid documentation concept in upcoming releases. The base concept balances stability and currentness by integrating core guidelines and standards directly into the server while syncing from the latest available PatternFly implementation. - **Baseline data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access. @@ -40,7 +40,7 @@ The server integrates the [patternfly/ai-helpers](https://github.com/patternfly/ - **Styling Standards**: CSS and styling requirements tailored for AI code generation. - **Prompt Engineering**: Includes `ai-prompt-guidance.md` to help users write more effective prompts for PatternFly. -These helpers are a core part of our [Hybrid documentation model](#hybrid-documentation-model-in-progress), acting as the bridge between stable design patterns and dynamic implementation details. +These helpers are a core part of our [Hybrid documentation](#hybrid-documentation-in-progress), acting as the bridge between stable design patterns and dynamic implementation details. ### Tools, resources, and prompts as customizable plugins @@ -87,7 +87,7 @@ flowchart TD Our roadmap focuses on expanding the server's reach and providing a more integrated development experience. #### In-progress -- **Hybrid documentation model**: A JSON API for documentation, components, and patterns that ensures the server is always in sync with the latest releases. +- **Hybrid documentation**: A JSON API for documentation, components, and patterns that ensures the server is always in sync with the latest releases. - **PatternFly API Integration**: Embedded integration into the server for standalone purposes, quick starts, and immediate access. - **Child Process Lifecycle Management**: Background process while you work for API synchronization. From 4fac4a6ecc2fabc880b2a2031de7c2bc61b8f54c Mon Sep 17 00:00:00 2001 From: CD Cabrera Date: Fri, 27 Mar 2026 16:34:12 -0400 Subject: [PATCH 7/7] fix: review update --- docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index d4e83c97..186a769b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -12,5 +12,5 @@ Welcome to the PatternFly MCP Server documentation. This guide is organized by u - **[Examples](./examples/README.md)**: Standalone snippets for HTTP transport, embedding, and custom tools. ### 🏗️ Architecture & design -- **[System Architecture](./architecture.md)**: Design concept and architecture. +- **[System Architecture](./architecture.md)**: Architecture and roadmap. - **[Roadmap](./architecture.md#roadmap)**: Future plans for the project.