multisite-cms-mcp 1.7.7 → 1.8.0

package/README.md

@@ -62,6 +62,19 @@ These tools work without authentication — perfect for converting and validatin
 | `get_example` | Get example code for common patterns |
 | `get_conversion_guide` | Step-by-step website conversion guide |
 
+### MCP Resources (Alternative to Tools)
+
+The server also exposes static content as **MCP Resources** that can be browsed and fetched:
+
+| Resource URI | Description |
+|--------------|-------------|
+| `fastmode://help` | Quick start guide |
+| `fastmode://reference/field-types` | Available field types for creating collections |
+| `fastmode://guide/{section}` | Conversion guide sections (full, first_steps, analysis, structure, seo, manifest, templates, tokens, forms, assets, checklist, common_mistakes) |
+| `fastmode://examples/{type}` | Code examples (manifest_basic, blog_post_template, form_handling, etc.) |
+
+Resources provide the same content as `get_field_types`, `get_conversion_guide`, and `get_example` tools but in a browsable format.
+
 ### What validate_template Checks
 
 The `validate_template` tool performs comprehensive validation:

package/dist/index.js

@@ -650,51 +650,125 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         };
     }
 });
-// Handle list resources request - helps agents that incorrectly call list_mcp_resources
+// Example types for resources
+const EXAMPLE_TYPES = [
+    'manifest_basic', 'manifest_custom_paths', 'manifest_minimal_with_ui',
+    'blog_index_template', 'blog_post_template', 'team_template', 'downloads_template',
+    'authors_template', 'author_detail_template', 'custom_collection_template',
+    'form_handling', 'asset_paths', 'image_handling', 'relation_fields', 'data_edit_keys',
+    'each_loop', 'conditional_if', 'nested_fields', 'featured_posts', 'parent_context',
+    'equality_comparison', 'comparison_helpers', 'youtube_embed', 'nested_collection_loop',
+    'loop_variables', 'common_mistakes'
+];
+// Guide sections for resources
+const GUIDE_SECTIONS = [
+    'full', 'first_steps', 'analysis', 'structure', 'seo', 'manifest',
+    'templates', 'tokens', 'forms', 'assets', 'checklist', 'common_mistakes'
+];
+// Handle list resources request
 server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
-    return {
-        resources: [
-            {
-                uri: 'fastmode://help',
-                name: 'How to Use FastMode MCP',
-                description: 'Instructions for using FastMode tools - READ THIS if tools are not working',
-                mimeType: 'text/plain',
-            },
-        ],
-    };
+    const resources = [
+        // Help resource
+        {
+            uri: 'fastmode://help',
+            name: 'How to Use FastMode MCP',
+            description: 'Quick start guide for using FastMode tools and resources',
+            mimeType: 'text/plain',
+        },
+        // Field types reference
+        {
+            uri: 'fastmode://reference/field-types',
+            name: 'Available Field Types',
+            description: 'List of field types for creating collections (text, richText, image, etc.)',
+            mimeType: 'text/plain',
+        },
+        // Guide sections
+        ...GUIDE_SECTIONS.map(section => ({
+            uri: `fastmode://guide/${section}`,
+            name: `Conversion Guide: ${section.replace(/_/g, ' ')}`,
+            description: `Website conversion guide - ${section} section`,
+            mimeType: 'text/plain',
+        })),
+        // Code examples
+        ...EXAMPLE_TYPES.map(type => ({
+            uri: `fastmode://examples/${type}`,
+            name: `Example: ${type.replace(/_/g, ' ')}`,
+            description: `Code example for ${type.replace(/_/g, ' ')}`,
+            mimeType: 'text/plain',
+        })),
+    ];
+    return { resources };
 });
 // Handle read resource request
 server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
-    if (request.params.uri === 'fastmode://help') {
+    const uri = request.params.uri;
+    // Help resource
+    if (uri === 'fastmode://help') {
         return {
-            contents: [
-                {
-                    uri: 'fastmode://help',
+            contents: [{
+                    uri,
                     mimeType: 'text/plain',
-                    text: `# FastMode MCP Server - How to Use
+                    text: `# FastMode MCP Server
 
-This server exposes TOOLS, not resources. To use FastMode:
+## Quick Start
+Call the **get_started** tool for guided help based on your task.
 
-## Available Tools (use CallMcpTool to call these):
+## Available Tools
+- **list_projects** - List your FastMode projects
+- **get_tenant_schema** - Get collections/fields for a project
+- **create_cms_item** / **update_cms_item** / **delete_cms_item** - Manage content
+- **deploy_package** - Deploy a website
+- **sync_schema** - Create collections and fields
+- **validate_manifest** / **validate_template** - Validate your code
 
-1. **list_projects** - List all your FastMode projects
-2. **get_tenant_schema** - Get collections/fields for a project  
-3. **create_cms_item** - Create content items
-4. **deploy_package** - Deploy a website
-5. **get_started** - CALL THIS FIRST for guided help
+## Available Resources
+- **fastmode://reference/field-types** - Field types for creating collections
+- **fastmode://guide/{section}** - Website conversion guide sections
+- **fastmode://examples/{type}** - Code examples for common patterns
 
-## Example:
-Call the "list_projects" tool with no arguments to see your projects.
-
-## Authentication:
-Authentication happens automatically via browser login on first use.
-
-DO NOT look for resources - use the TOOLS listed above.`,
-                },
-            ],
+## Authentication
+Authentication happens automatically via browser login on first use.`,
+                }],
+        };
+    }
+    // Field types reference
+    if (uri === 'fastmode://reference/field-types') {
+        const content = await (0, get_field_types_1.getFieldTypes)();
+        return {
+            contents: [{
+                    uri,
+                    mimeType: 'text/plain',
+                    text: content,
+                }],
+        };
+    }
+    // Guide sections
+    const guideMatch = uri.match(/^fastmode:\/\/guide\/(.+)$/);
+    if (guideMatch) {
+        const section = guideMatch[1];
+        const content = await (0, get_conversion_guide_1.getConversionGuide)(section);
+        return {
+            contents: [{
+                    uri,
+                    mimeType: 'text/plain',
+                    text: content,
+                }],
+        };
+    }
+    // Code examples
+    const exampleMatch = uri.match(/^fastmode:\/\/examples\/(.+)$/);
+    if (exampleMatch) {
+        const exampleType = exampleMatch[1];
+        const content = await (0, get_example_1.getExample)(exampleType);
+        return {
+            contents: [{
+                    uri,
+                    mimeType: 'text/plain',
+                    text: content,
+                }],
         };
     }
-    throw new Error(`Unknown resource: ${request.params.uri}`);
+    throw new Error(`Unknown resource: ${uri}`);
 });
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.7.7",
+  "version": "1.8.0",
   "description": "MCP server for Fast Mode CMS. Convert websites, validate packages, and deploy directly to Fast Mode. Includes authentication, project creation, schema sync, and one-click deployment.",
   "main": "dist/index.js",
   "bin": {