feat(pluggable-widgets-mcp): addition of resources and build tools, default to stdio

Author: rahmanunver

package.json

@@ -13,6 +13,7 @@
         "create-gh-release": "turbo run create-gh-release --concurrency 1",
         "create-translation": "turbo run create-translation",
         "postinstall": "turbo run agent-rules",
+        "start:mcp": "pnpm --filter pluggable-widgets-mcp run start",
         "lint": "turbo run lint --continue --concurrency 1",
         "prepare": "husky install",
         "prepare-release": "pnpm --filter @mendix/automation-utils run prepare-release",

packages/pluggable-widgets-mcp/.prettierrc.js

@@ -8,10 +8,26 @@ A Model Context Protocol (MCP) server that enables AI assistants to scaffold Men
 
 ```bash
 pnpm install
+pnpm build          # Build the server
 pnpm start          # HTTP mode (default)
 pnpm start:stdio    # STDIO mode
 ```
 
+## Global Installation
+
+For use with MCP clients (Cursor, Claude Desktop, LMStudio), install globally:
+
+```bash
+# Build first
+pnpm build
+
+# Link globally using npm (NOT pnpm - better MCP client compatibility)
+npm link
+
+# Verify installation
+which pluggable-widgets-mcp
+```
+
 ## Transport Modes
 
 ### HTTP Mode (default)
@@ -53,6 +69,21 @@ pnpm start:stdio
 
 **_Some client setups like Claude Desktop support STDIO only (for now)_**
 
+**Option 1: Global command (after `npm link`)**
+
+```json
+{
+    "mcpServers": {
+        "pluggable-widgets-mcp": {
+            "command": "pluggable-widgets-mcp",
+            "args": ["stdio"]
+        }
+    }
+}
+```
+
+**Option 2: Absolute path (more reliable during development)**
+
 ```json
 {
     "mcpServers": {
@@ -64,6 +95,8 @@ pnpm start:stdio
 }
 ```
 
+> **Note:** After rebuilding the server, you may need to restart/reconnect your MCP client to pick up changes.
+
 ## Available Tools
 
 ### create-widget
@@ -85,6 +118,34 @@ Scaffolds a new Mendix pluggable widget using `@mendix/generator-widget`.
 
 Generated widgets are placed in `generations/` directory within this package.
 
+### File Operation Tools
+
+| Tool                       | Description                                                  |
+| -------------------------- | ------------------------------------------------------------ |
+| `list-widget-files`        | Lists all files in a widget directory, grouped by type       |
+| `read-widget-file`         | Reads the contents of a file from a widget directory         |
+| `write-widget-file`        | Writes content to a file (creates parent dirs automatically) |
+| `batch-write-widget-files` | Writes multiple files atomically                             |
+
+**Security:** Path traversal is blocked; only allowed extensions: `.tsx`, `.ts`, `.xml`, `.scss`, `.css`, `.json`, `.md`
+
+### build-widget
+
+Builds a widget using `pluggable-widgets-tools`, producing an `.mpk` file.
+
+| Parameter    | Required | Description                           |
+| ------------ | -------- | ------------------------------------- |
+| `widgetPath` | Yes      | Absolute path to the widget directory |
+
+Returns structured errors for TypeScript, XML, or dependency issues.
+
+## Available Resources
+
+| URI                                   | Description                                                                |
+| ------------------------------------- | -------------------------------------------------------------------------- |
+| `mendix://guidelines/property-types`  | Complete reference for all Mendix widget property types                    |
+| `mendix://guidelines/widget-patterns` | Reusable patterns for common widget types (Button, Input, Container, etc.) |
+
 ## Development
 
 ```bash
@@ -135,13 +196,15 @@ This is useful for verifying tool behavior without needing a full AI client inte
 
 ## Roadmap
 
-- [x] Widget scaffolding
+- [x] Widget scaffolding (`create-widget`)
 - [x] HTTP transport
 - [x] STDIO transport
 - [x] Progress notifications
-- [ ] Widget editing and modification
-- [ ] Property management
-- [ ] Build and deployment tools
+- [x] File operations (list, read, write, batch-write)
+- [x] Build tool (`build-widget`)
+- [x] Guideline resources (property-types, widget-patterns)
+- [ ] Widget property editing (XML manipulation)
+- [ ] TypeScript error recovery suggestions
 
 ## License