[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_110":111},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","hewlettpackard","moduleId","gl-mcp","@hewlettpackard/gl-mcp","displayName","gl mcp","tagline","HPE GreenLake audit-logs MCP Server","iconKey","https://avatars.githubusercontent.com/u/6004705?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783335143000,"updatedAt",1788775427000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.HewlettPackard%2Fgreenlake-audit-logs-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",9,"upstreamUpdatedAt",1779801497000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/HewlettPackard/gl-mcp","githubRepoFullName","HewlettPackard/gl-mcp","releaseId","ext-hewlettpackard-gl-mcp","version","1.1.2","descriptionMarkdown","# HPE GreenLake MCP Servers\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)\n[![Python Versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](https://www.python.org/downloads/)\n[![Code style: ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![Security Policy](https://img.shields.io/badge/Security-Policy-green.svg)](./.github/SECURITY.md)\n[![CI Status](https://github.com/HewlettPackard/gl-mcp/actions/workflows/ci-public.yml/badge.svg)](https://github.com/HewlettPackard/gl-mcp/actions/workflows/ci-public.yml)\n\n\nA collection of [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers that enable AI assistants to interact with HPE GreenLake platform services.\n\n## Table of Contents\n\n- [What is the Model Context Protocol?](#what-is-the-model-context-protocol)\n- [What's in this Repository?](#whats-in-this-repository)\n- [Available MCP Servers](#available-mcp-servers)\n- [Quick Start](#quick-start)\n- [MCP Client Configuration](#mcp-client-configuration)\n- [Tool Modes](#tool-modes)\n- [Architecture Overview](#architecture-overview)\n- [Security Considerations](#security-considerations)\n- [Troubleshooting](#troubleshooting)\n- [Getting Help](#getting-help)\n- [Resources](#resources)\n- [License](#license)\n\n## What is the Model Context Protocol?\n\nThe Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools.\nWhether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.\n\n## What's in this Repository?\n\nThis repository contains production-ready MCP servers for HPE GreenLake platform services. Each server provides AI assistants with secure, read-only access to specific GreenLake APIs, enabling natural language interactions with your HPE infrastructure.\n\n### Key Features\n\n- **Standardized Architecture**: All servers follow consistent patterns for authentication, configuration, and error handling\n- **OAuth2 Authentication**: Secure access using HPE GreenLake workspace credentials with automatic token management\n- **Dual Tool Modes**: Each server supports both static (individual tools per endpoint) and dynamic (meta-tools) operation modes\n- **Type-Safe**: Built with Pydantic models for runtime validation and type safety\n- **Production Ready**: Comprehensive logging, error handling, and Docker support\n- **Well Tested**: Extensive unit and integration test coverage\n\n## Available MCP Servers\n\n| Service | Category | Description | Key Capabilities |\n|---------|----------|-------------|-----------------|\n| [Devices](https://github.com/HewlettPackard/gl-mcp/blob/main/src/devices/README.md) | Infrastructure & Platform | Manage and query HPE GreenLake devices in your workspace | Filter by type, serial number, tags; retrieve device details by ID |\n| [Workspaces](https://github.com/HewlettPackard/gl-mcp/blob/main/src/workspaces/README.md) | Infrastructure & Platform | Interact with HPE GreenLake workspace management APIs | List/query workspaces; retrieve details and configurations |\n| [Subscriptions](https://github.com/HewlettPackard/gl-mcp/blob/main/src/subscriptions/README.md) | Infrastructure & Platform | Access subscription information and licensing details | View active subscriptions; query licensing; monitor subscription status |\n| [Audit Logs](https://github.com/HewlettPackard/gl-mcp/blob/main/src/audit-logs/README.md) | Security & Compliance | Query and analyze HPE GreenLake audit logs | Filter by category, user, timestamp; track user activities and system events |\n| [Users](https://github.com/HewlettPackard/gl-mcp/blob/main/src/users/README.md) | User & Access Management | Manage user accounts and access controls | List/query users; view permissions; monitor user activity |\n| [Reporting](https://github.com/HewlettPackard/gl-mcp/blob/main/src/reporting/README.md) | Reporting & Analytics | Generate and retrieve reports on workspaces, devices, and subscriptions | Customizable report types; async report tracking; date range and column filters |\n| [Service Catalog](https://github.com/HewlettPackard/gl-mcp/blob/main/src/service-catalog/README.md) | Infrastructure & Platform | Access service catalog and provisioning information | View service offers, provisions, managers, manager-provisions and regions |\n\n## Quick Start\n\n### Prerequisites\n\n- Python 3.10 or higher\n- [uv](https://github.com/astral-sh/uv) package manager\n- HPE GreenLake workspace with API credentials\n\n### Configuration\n\nAll servers require the following HPE GreenLake credentials:\n\n```bash\nexport GREENLAKE_API_BASE_URL=\"https://global.api.greenlake.hpe.com\"\nexport GREENLAKE_CLIENT_ID=\"your-client-id\"\nexport GREENLAKE_CLIENT_SECRET=\"your-client-secret\"\nexport GREENLAKE_WORKSPACE_ID=\"your-workspace-id\"\n```\n\n### Running a Server\n\n```bash\n# Navigate to a server directory\ncd src/audit-logs\n\n# Install dependencies\nuv sync\n\n# Run the server\nuv run python -m greenlake_audit_logs_mcp\n```\n\n## MCP Client Configuration\n\n### Claude Desktop\n\nAdd servers to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"greenlake-audit-logs\": {\n \"command\": \"uv\",\n \"args\": [\"run\", \"python\", \"-m\", \"greenlake_audit_logs_mcp\"],\n \"cwd\": \"/path/to/gl-mcp/src/audit-logs\",\n \"env\": {\n \"GREENLAKE_API_BASE_URL\": \"https://global.api.greenlake.hpe.com\",\n \"GREENLAKE_CLIENT_ID\": \"your-client-id\",\n \"GREENLAKE_CLIENT_SECRET\": \"your-client-secret\",\n \"GREENLAKE_WORKSPACE_ID\": \"your-workspace-id\"\n }\n },\n \"greenlake-devices\": {\n \"command\": \"uv\",\n \"args\": [\"run\", \"python\", \"-m\", \"greenlake_devices_mcp\"],\n \"cwd\": \"/path/to/gl-mcp/src/devices\",\n \"env\": {\n \"GREENLAKE_API_BASE_URL\": \"https://global.api.greenlake.hpe.com\",\n \"GREENLAKE_CLIENT_ID\": \"your-client-id\",\n \"GREENLAKE_CLIENT_SECRET\": \"your-client-secret\",\n \"GREENLAKE_WORKSPACE_ID\": \"your-workspace-id\"\n }\n }\n }\n}\n```\n\n### Other MCP Clients\n\nThese servers use the standard `stdio` transport and work with any MCP-compatible client. See individual server READMEs for specific configuration examples.\n\n## Tool Modes\n\nAll servers support two operation modes that can be switched at runtime using the `MCP_TOOL_MODE` environment variable:\n\n### Static Mode (Default)\n\n- **Individual tools**: Each API endpoint becomes a dedicated MCP tool\n- **Type-safe**: Explicit tool definitions with compile-time validation\n- **Discoverable**: Tools appear individually in MCP client interfaces\n- **Best for**: Smaller APIs and focused workflows\n\n```bash\nexport MCP_TOOL_MODE=static\n```\n\n### Dynamic Mode\n\n- **Meta-tools**: 3 generic tools that can handle any API endpoint\n - `list_endpoints` - Discover available API endpoints\n - `get_endpoint_schema` - Get detailed schema information\n - `invoke_dynamic_tool` - Execute API calls with runtime validation\n- **Memory efficient**: Lower overhead for large APIs\n- **Best for**: Large APIs with many endpoints\n\n```bash\nexport MCP_TOOL_MODE=dynamic\n```\n\n### Compatibility Matrix\n\n| Python Version | Status | Notes |\n|----------------|--------|-------|\n| 3.12 | ✅ Supported | Recommended |\n| 3.11 | ✅ Supported | Recommended |\n| 3.10 | ✅ Supported | Minimum version |\n\n## Architecture Overview\n\n### High-Level Architecture\n\n```mermaid\nflowchart TB\n subgraph clients[\" MCP Clients \"]\n direction TB\n claude[\"Claude Desktop\"]\n vscode[\"VS Code\"]\n other[\"...\"]\n end\n\n subgraph servers[\" MCP Servers \"]\n direction TB\n audit[\"Audit Logs\"]\n devices[\"Devices\"]\n users[\"Users\"]\n workspaces[\"Workspaces\"]\n subscriptions[\"Subscriptions\"]\n reporting[\"Reporting\"]\n serviceX[\"...\"]\n \n subgraph shared[\" Shared Components \"]\n direction LR\n oauth[\"OAuth2 Token Manager
(with caching)\"]\n end\n end\n\n subgraph platform[\" HPE GreenLake Platform \"]\n direction TB\n api[\"APIs\"]\n end\n\n clients ==>|JSON-RPC/stdio| servers\n servers ==>|HTTPS/REST + OAuth2| platform\n\n classDef clientStyle fill:#2196F3,stroke:none,color:#fff,rx:10,ry:10\n classDef serverStyle fill:#4CAF50,stroke:none,color:#fff,rx:10,ry:10\n classDef authStyle fill:#FF9800,stroke:none,color:#fff,rx:10,ry:10\n classDef platformStyle fill:#01a982,stroke:none,color:#fff,rx:10,ry:10\n classDef clientContainerStyle fill:none,stroke:#2196F3,stroke-width:3px,rx:15,ry:15\n classDef serverContainerStyle fill:none,stroke:#4CAF50,stroke-width:3px,rx:15,ry:15\n classDef authContainerStyle fill:none,stroke:#FF9800,stroke-width:2px,stroke-dasharray:5 5,rx:10,ry:10\n classDef platformContainerStyle fill:none,stroke:#01a982,stroke-width:3px,rx:15,ry:15\n \n class claude,vscode,other clientStyle\n class audit,devices,users,workspaces,subscriptions,reporting,serviceX serverStyle\n class oauth authStyle\n class api platformStyle\n class clients clientContainerStyle\n class servers serverContainerStyle\n class shared authContainerStyle\n class platform platformContainerStyle\n```\n\n### Request Flow\n\n1. **Client Request**: MCP client sends tool invocation via JSON-RPC over stdio\n2. **Authentication**: Server authenticates with HPE GreenLake using OAuth2 (tokens cached and auto-refreshed)\n3. **API Call**: Server makes authenticated HTTPS request to GreenLake API\n4. **Response**: Server processes response and returns data to client via MCP protocol\n\n### Shared Components\n\nAll servers share a common architecture:\n\n```text\nsrc//\n├── greenlake__mcp/ # Main package (e.g. greenlake_audit_logs_mcp)\n│ ├── __main__.py # Entry point (python -m greenlake__mcp)\n│ ├── auth/ # OAuth2 authentication\n│ ├── config/ # Settings and logging\n│ ├── models/ # Pydantic data models\n│ ├── server/ # MCP server core\n│ ├── tools/ # Tool implementations\n│ │ ├── base.py # Base tool class\n│ │ ├── registry.py # Tool registration\n│ │ └── implementations/ # Tool implementations\n│ └── utils/ # HTTP client and utilities\n├── tests/ # Unit and integration tests\n└── pyproject.toml # Package definition and entry points\n```\n\n### Authentication\n\nAll servers use OAuth2 client credentials flow with automatic token management:\n\n- Tokens are cached and automatically refreshed\n- Thread-safe token management\n- Configurable retry logic with exponential backoff\n\n### Logging\n\nServers use structured logging with MCP protocol compliance:\n\n- **stderr**: Diagnostic logs (controlled by `GREENLAKE_LOG_LEVEL`)\n- **File logging**: Optional detailed logging to `~/.hpe/mcp-logs/`\n- **stdout**: Reserved for JSON-RPC messages only\n\n## Security Considerations\n\n- **Read-Only Access**: All servers provide read-only API access by design\n- **Credential Management**: Never commit credentials to version control\n- **Token Security**: OAuth2 tokens are cached in memory only\n- **Workspace Isolation**: Operations are scoped to the configured workspace\n- **HTTPS Only**: All API communications use TLS encryption\n\n## Troubleshooting\n\n### Common Issues\n\n**Server won't start:**\n\n- Verify all required environment variables are set\n- Check that `uv` is installed and dependencies are synced\n- Review stderr output for configuration errors\n\n**Authentication failures:**\n\n- Verify client credentials are valid for your workspace\n- Ensure `GREENLAKE_WORKSPACE_ID` matches your credential scope\n- Check network connectivity to GreenLake APIs\n\n**MCP client connection issues:**\n\n- Verify the `cwd` path in client configuration is correct\n- Check that the server starts successfully when run manually\n- Review client logs for specific error messages\n\n### Debug Logging\n\nEnable detailed logging for troubleshooting:\n\n```bash\nexport GREENLAKE_LOG_LEVEL=DEBUG\nexport GREENLAKE_FILE_LOGGING=true\n```\n\nLog files are written to: `~/.hpe/mcp-logs/{service-name}/`\n\n## Getting Help\n\n### GitHub Issues\n\nThe primary support channel for this project is [GitHub Issues](https://github.com/HewlettPackard/gl-mcp/issues). When reporting an issue, please include:\n\n- **Environment details**: OS, Python version, `uv` version\n- **Server name**: Which MCP server you're using (audit-logs, devices, etc.)\n- **Error messages**: Complete error output with stack traces\n- **Configuration**: Relevant environment variable settings (DO NOT include credentials)\n- **Steps to reproduce**: Detailed description of how to reproduce the issue\n\n### Before Opening an Issue\n\n1. **Check existing issues**: Search [open](https://github.com/HewlettPackard/gl-mcp/issues) and [closed](https://github.com/HewlettPackard/gl-mcp/issues?q=is%3Aissue+is%3Aclosed) issues\n2. **Review troubleshooting**: Check the [Troubleshooting](#troubleshooting) section above\n3. **Enable debug logging**: Run with `GREENLAKE_LOG_LEVEL=DEBUG` and `GREENLAKE_FILE_LOGGING=true` to gather detailed logs\n4. **Test authentication**: Verify your credentials work with the GreenLake APIs directly\n\n### Issue Types\n\n- **Bug Report**: For unexpected behavior, errors, or crashes\n- **Feature Request**: For suggesting new capabilities or improvements\n- **Question**: For clarification on usage, configuration, or architecture\n- **Documentation**: For reporting documentation issues or suggesting improvements\n\n## Resources\n\n- [Model Context Protocol Documentation](https://modelcontextprotocol.io)\n- [HPE GreenLake API Documentation](https://developer.greenlake.hpe.com/docs/greenlake/services)\n- [MCP Specification](https://modelcontextprotocol.io/specification/latest)\n\n## License\n\nThis project is licensed under the Apache 2.0 - see the [LICENSE](https://github.com/HewlettPackard/gl-mcp/blob/main/LICENSE) file for details.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":81,"_93":81},"ratingAvg","reviewCount","topics",[],"license","Apache-2.0","language","Python","registryName","io.github.HewlettPackard/greenlake-audit-logs-mcp","homepage","packages",[105],{"_106":107,"_108":109,"_71":72},"registryType","pypi","identifier","greenlake-audit-logs-mcp","ENV",{"_112":113,"_114":115,"_116":117},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]