PatternFly MCP 服务器

一个基于 Node.js 构建的模型上下文协议(MCP)服务器,为开发者和设计人员提供 PatternFly 设计系统的规则、文档和资源访问能力,支持 IDE 集成、HTTP 传输及嵌入式应用等多种使用方式。

  • by patternfly
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 patternfly/patternfly-mcp

使用说明

PatternFly MCP Server

A Model Context Protocol (MCP) server that provides access to PatternFly rules and documentation, built with Node.js.

The PatternFly MCP server is a comprehensive library resource for PatternFly. It is intended to be extensible to meet the needs of different teams and projects, from simple to complex, from design to development. Read more about our roadmap and how we've structured the server in our architecture docs.

Requirements

Quick start

The PatternFly MCP Server supports multiple configurations; see the usage documentation for details.

For integrated use with an IDE

Set a basic MCP configuration

Unable to update to the required Node.js version? See pinned MCP configuration examples for earlier Node.js versions.

Minimal configuration

{
  "mcpServers": {
    "patternfly-mcp": {
      "command": "npx",
      "args": ["-y", "@patternfly/patternfly-mcp@latest"],
      "description": "PatternFly rules and documentation"
    }
  }
}

HTTP transport mode

{
  "mcpServers": {
    "patternfly-mcp": {
      "command": "npx",
      "args": ["-y", "@patternfly/patternfly-mcp@latest", "--http", "--port", "8080"],
      "description": "PatternFly rules and documentation (HTTP transport)"
    }
  }
}

See the MCP Server Configuration documentation for more examples.

For development, advanced usage

Run the latest released server

Run the latest published package immediately via npx:

npx -y @patternfly/patternfly-mcp@latest

Or with options

npx -y @patternfly/patternfly-mcp@latest --log-stderr --verbose

Run a locally built server

# clone the repo, change the directory, npm install, npm run build, then in the repo context run...
npm start

Inspect the server

Visualize and test the packaged MCP interface:

npx -y @modelcontextprotocol/inspector npx -y @patternfly/patternfly-mcp@latest

Build from source and test a local built MCP interface:

# clone the repo, change the directory, npm install, npm run build, then in the repo context run...
npx -y @modelcontextprotocol/inspector node dist/cli.js

Embed the server in your application

import { start } from '@patternfly/patternfly-mcp';

// Remember to avoid using console.log and info, they pollute STDOUT
async function main() {
  const server = await start();

  // Graceful shutdown
  process.on('SIGINT', async () => {
    await server.stop();
    process.exit(0);
  });
}

main();

See the development documentation for additional examples, CLI and embedded server options.

Documentation

For comprehensive usage, development, and project state read the docs.

Security & Governance

See SECURITY.md for vulnerability reporting and GOVERNANCE.md for how contributions are reviewed.

Contributing

Contributing? Guidelines can be found here CONTRIBUTING.md.

AI agent

If you're using an AI assistant to help with development in this repository, please prompt it to review the repo guidelines to ensure adherence to project conventions.

Guidelines for developer-agent interaction can be found in CONTRIBUTING.md.