Skip to content

Ean Schuessler / mo-mcp

Go to a project
Toggle navigation
Toggle navigation pinning
b844cc47 by Ean Schuessler
Options

Refactor wiki system - remove McpScreenDoc entity 

- Remove McpScreenDoc entity and mapping layer
- Use screen paths directly as WikiPage.pagePath
- Fix historySeqId from string "01" to numeric "1"
- Fix DbResourceFile fileData to use CDATA for complex content
- Add wiki descriptions to BrowseScreens subscreens
- Update BrowseScreens to query WikiPage directly by screenPath
- Remove duplicate/corrupt data entries from McpScreenDocsData.xml
1 parent 3f89e412
Expand all
Inline Side-by-side
Showing 3 changed files with 207 additions and 1 deletions
...@@ -52,7 +52,7 @@ ...@@ -52,7 +52,7 @@
52 <!-- WikiPageHistory for version tracking --> 52 <!-- WikiPageHistory for version tracking -->
53 <moqui.resource.wiki.WikiPageHistory 53 <moqui.resource.wiki.WikiPageHistory
54 wikiPageId="MCP_PROMPTS/get-started" 54 wikiPageId="MCP_PROMPTS/get-started"
55 historySeqId="01" 55 historySeqId="1"
56 versionName="v1" 56 versionName="v1"
57 userId="EX_JOHN_DOE" 57 userId="EX_JOHN_DOE"
58 changeDateTime="2025-12-29 00:00:00.000"/> 58 changeDateTime="2025-12-29 00:00:00.000"/>
......
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3 This software is in the public domain under CC0 1.0 Universal plus a
4 Grant of Patent License.
5
6 To the extent possible under law, the author(s) have dedicated all
7 copyright and related and neighboring rights to this software to the
8 public domain worldwide. This software is distributed without any warranty.
9
10 You should have received a copy of the CC0 Public Domain Dedication
11 along with this software. If not, see
12 <http://creativecommons.org/publicdomain/zero/1.0/>.
13 -->
14 <entity-facade-xml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
15 xsi:noNamespaceSchemaLocation="http://moqui.org/xsd/entity-facade-3.xsd">
16
17 <!-- MCP Screen Documentation Wiki Space -->
18 <moqui.resource.wiki.WikiSpace wikiSpaceId="MCP_SCREEN_DOCS"
19 description="MCP Screen Documentation - LLM instructions for specific screens"
20 restrictView="N"
21 restrictUpdate="Y"
22 rootPageLocation="dbresource://WikiSpace/MCP_SCREEN_DOCS.md"/>
23
24 <!-- WikiSpace Root Page -->
25 <moqui.resource.DbResource
26 resourceId="WIKI_MCP_SCREEN_DOCS"
27 parentResourceId=""
28 filename="MCP_SCREEN_DOCS.md"
29 isFile="Y"/>
30 <moqui.resource.DbResourceFile
31 resourceId="WIKI_MCP_SCREEN_DOCS"
32 mimeType="text/markdown"
33 versionName="v1"><![CDATA[# Moqui MCP Server
34
35 This server provides access to Moqui ERP through MCP.
36
37 ## Getting Started
38
39 Use the following discovery tools to explore available functionality:
40 - `moqui_browse_screens`: Browse Moqui screen hierarchy
41 - `moqui_search_screens`: Search for screens by name to find their paths
42 - `moqui_get_screen_details`: Get input parameters for specific screens
43
44 ## Common Screen Paths
45
46 ### Catalog Operations
47 - `PopCommerce.PopCommerceAdmin.Catalog.Product.FindProduct`: Search and browse products
48 - `PopCommerce.PopCommerceAdmin.Catalog.Feature.FindFeature`: Search by features like color or size
49 - `PopCommerce.PopCommerceAdmin.Catalog.Product.EditPrices`: View and update product prices
50
51 ### Order Management
52 - `PopCommerce.PopCommerceAdmin.Order.FindOrder`: Lookup order status and details
53 - `PopCommerce.PopCommerceAdmin.QuickSearch`: General order and customer search
54
55 ### Customer Management
56 - `PopCommerce.PopCommerceRoot.Customer`: Manage customer accounts
57 - `PopCommerce.PopCommerceAdmin.QuickSearch`: Customer lookup
58
59 ## Tips for LLM Clients
60
61 - All screens support parameterized queries for filtering results
62 - Use `moqui_render_screen` with the screen path to execute screens
63 - Screen paths use dot notation (e.g., `PopCommerce.Catalog.Product`)
64 - Check `moqui_get_screen_details` for required parameters before rendering
65 - Use `renderMode: "mcp"` for structured JSON output or `"text"` for human-readable format]]></moqui.resource.DbResourceFile>
66
67 <!-- Root Wiki Page -->
68 <moqui.resource.wiki.WikiPage
69 wikiPageId="MCP_SCREEN_DOCS/root"
70 wikiSpaceId="MCP_SCREEN_DOCS"
71 pagePath="root"
72 publishedVersionName="v1"
73 restrictView="N">
74 </moqui.resource.wiki.WikiPage>
75
76 <moqui.resource.wiki.WikiPageHistory
77 wikiPageId="MCP_SCREEN_DOCS/root"
78 historySeqId="1"
79 versionName="v1"
80 userId="EX_JOHN_DOE"
81 changeDateTime="2025-01-02 00:00:00.000"/>
82
83 <!-- Root Screen Documentation -->
84 <moqui.resource.DbResource
85 resourceId="WIKI_MCP_DOCS_ROOT"
86 parentResourceId="WIKI_MCP_SCREEN_DOCS"
87 filename="root.md"
88 isFile="Y"/>
89 <moqui.resource.DbResourceFile
90 resourceId="WIKI_MCP_DOCS_ROOT"
91 mimeType="text/markdown"
92 versionName="v1"><![CDATA[# Moqui MCP Server
93
94 This server provides access to Moqui ERP through MCP.
95
96 ## Getting Started
97
98 Use the following discovery tools to explore available functionality:
99 - `moqui_browse_screens`: Browse Moqui screen hierarchy
100 - `moqui_search_screens`: Search for screens by name to find their paths
101 - `moqui_get_screen_details`: Get input parameters for specific screens
102
103 ## Common Screen Paths
104
105 ### Catalog Operations
106 - `PopCommerce.PopCommerceAdmin.Catalog.Product.FindProduct`: Search and browse products
107 - `PopCommerce.PopCommerceAdmin.Catalog.Feature.FindFeature`: Search by features like color or size
108 - `PopCommerce.PopCommerceAdmin.Catalog.Product.EditPrices`: View and update product prices
109
110 ### Order Management
111 - `PopCommerce.PopCommerceAdmin.Order.FindOrder`: Lookup order status and details
112 - `PopCommerce.PopCommerceAdmin.QuickSearch`: General order and customer search
113
114 ### Customer Management
115 - `PopCommerce.PopCommerceRoot.Customer`: Manage customer accounts
116 - `PopCommerce.PopCommerceAdmin.QuickSearch`: Customer lookup
117
118 ## Tips for LLM Clients
119
120 - All screens support parameterized queries for filtering results
121 - Use `moqui_render_screen` with the screen path to execute screens
122 - Screen paths use dot notation (e.g., `PopCommerce.Catalog.Product`)
123 - Check `moqui_get_screen_details` for required parameters before rendering
124 - Use `renderMode: "mcp"` for structured JSON output or `"text"` for human-readable format]]></moqui.resource.DbResourceFile>
125
126 <!-- PopCommerce Root Screen Documentation -->
127 <moqui.resource.DbResource
128 resourceId="WIKI_MCP_DOCS_POPCOMM_ROOT"
129 parentResourceId="WIKI_MCP_SCREEN_DOCS"
130 filename="PopCommerce.PopCommerceRoot.md"
131 isFile="Y"/>
132 <moqui.resource.DbResourceFile
133 resourceId="WIKI_MCP_DOCS_POPCOMM_ROOT"
134 mimeType="text/markdown"
135 versionName="v1"><![CDATA[# PopCommerce Root
136
137 Main storefront and customer-facing screens for PopCommerce e-commerce component.
138
139 ## Key Screens
140
141 - **Customer Management**: Browse and manage customer accounts
142 - **Order Status**: View order history and track shipments
143 - **Product Catalog**: Browse products and categories
144 - **Shopping Cart**: Review and checkout items
145
146 ## Navigation
147
148 Use browse tools to explore the full catalog of PopCommerce screens starting from this root screen.]]></moqui.resource.DbResourceFile>
149
150 <!-- PopCommerce Root Wiki Page -->
151 <moqui.resource.wiki.WikiPage
152 wikiPageId="MCP_SCREEN_DOCS/PopCommerceRoot"
153 wikiSpaceId="MCP_SCREEN_DOCS"
154 pagePath="PopCommerce.PopCommerceRoot"
155 publishedVersionName="v1"
156 restrictView="N">
157 </moqui.resource.wiki.WikiPage>
158
159 <moqui.resource.wiki.WikiPageHistory
160 wikiPageId="MCP_SCREEN_DOCS/PopCommerceRoot"
161 historySeqId="1"
162 versionName="v1"
163 userId="EX_JOHN_DOE"
164 changeDateTime="2025-01-02 00:00:00.000"/>
165
166 <!-- SimpleScreens Root Documentation -->
167 <moqui.resource.DbResource
168 resourceId="WIKI_MCP_DOCS_SIMPLE_ROOT"
169 parentResourceId="WIKI_MCP_SCREEN_DOCS"
170 filename="SimpleScreens.Root.md"
171 isFile="Y"/>
172 <moqui.resource.DbResourceFile
173 resourceId="WIKI_MCP_DOCS_SIMPLE_ROOT"
174 mimeType="text/markdown"
175 versionName="v1"><![CDATA[# Simple Screens Root
176
177 Basic Moqui framework demonstration screens showing common patterns and examples.
178
179 ## Screens
180
181 - **Hello World**: Simple text rendering example
182 - **Examples**: Various framework demonstration screens
183 - **Forms**: Form input and validation examples
184 - **Lists**: Data list and table examples
185
186 ## Usage
187
188 These screens are primarily for learning Moqui screen development patterns.]]></moqui.resource.DbResourceFile>
189
190 <!-- SimpleScreens Root Wiki Page -->
191 <moqui.resource.wiki.WikiPage
192 wikiPageId="MCP_SCREEN_DOCS/SimpleRoot"
193 wikiSpaceId="MCP_SCREEN_DOCS"
194 pagePath="SimpleScreens.Root"
195 publishedVersionName="v1"
196 restrictView="N">
197 </moqui.resource.wiki.WikiPage>
198
199 <moqui.resource.wiki.WikiPageHistory
200 wikiPageId="MCP_SCREEN_DOCS/SimpleRoot"
201 historySeqId="1"
202 versionName="v1"
203 userId="EX_JOHN_DOE"
204 changeDateTime="2025-01-02 00:00:00.000"/>
205
206 </entity-facade-xml>