ftc-mcp 1.0.0 → 1.1.0

package/build/resources/registry.js

@@ -1,520 +1,51 @@
 "use strict";
+/**
+ * MCP Resource Registration — Template-Based
+ *
+ * Inspired by Cloudflare's progressive discovery pattern: instead of registering
+ * 70+ individual resources (each adding to context window overhead), we register
+ * 9 category-level resource templates. Each template provides a list callback for
+ * resource discovery and a read callback for content retrieval.
+ *
+ * This reduces the resource listing from ~70 entries to 9 templates, saving
+ * significant tokens in the MCP protocol's resource listing.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerResources = registerResources;
-const pedro_js_1 = require("../knowledge/pedro.js");
-const dashboard_js_1 = require("../knowledge/dashboard.js");
-const hardware_js_1 = require("../knowledge/hardware.js");
-const ftc_sdk_js_1 = require("../knowledge/ftc-sdk.js");
-const gradle_js_1 = require("../knowledge/gradle.js");
-const roadrunner_js_1 = require("../knowledge/roadrunner.js");
-const ftclib_js_1 = require("../knowledge/ftclib.js");
-const vision_js_1 = require("../knowledge/vision.js");
-const panels_js_1 = require("../knowledge/panels.js");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const index_js_1 = require("../knowledge/index.js");
 function registerResources(server) {
-    // ── Core SDK (FTC_SDK_KNOWLEDGE) ──────────────────────────────────────
-    server.resource("FTC Overview", "ftc://sdk/overview", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.overview
-            }]
-    }));
-    server.resource("OpMode Patterns", "ftc://sdk/opmode-patterns", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.opmodePatterns
-            }]
-    }));
-    server.resource("Hardware Map", "ftc://sdk/hardware-map", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.hardwareMap
-            }]
-    }));
-    server.resource("Gamepad API", "ftc://sdk/gamepad-api", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.gamepadApi
-            }]
-    }));
-    server.resource("Best Practices", "ftc://sdk/best-practices", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.bestPractices
-            }]
-    }));
-    server.resource("Dev Environment Setup", "ftc://sdk/dev-environment", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftc_sdk_js_1.FTC_SDK_KNOWLEDGE.devEnvironment
-            }]
-    }));
-    // ── Pedro Pathing (PEDRO_KNOWLEDGE) ───────────────────────────────────
-    server.resource("Pedro API Reference", "ftc://pedro/api-reference", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.apiReference
-            }]
-    }));
-    server.resource("Pedro Constants Pattern", "ftc://pedro/constants-pattern", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.constantsPattern
-            }]
-    }));
-    server.resource("Pedro Coordinate System", "ftc://pedro/coordinate-system", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.coordinateSystem
-            }]
-    }));
-    server.resource("Pedro Auto Structure", "ftc://pedro/auto-structure", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.autoStructure
-            }]
-    }));
-    server.resource("Pedro TeleOp Structure", "ftc://pedro/teleop-structure", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.teleopStructure
-            }]
-    }));
-    server.resource("Pedro Callbacks", "ftc://pedro/callbacks", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: pedro_js_1.PEDRO_KNOWLEDGE.callbacks
-            }]
-    }));
-    // ── Dashboard (DASHBOARD_KNOWLEDGE) ───────────────────────────────────
-    server.resource("Dashboard Config Pattern", "ftc://dashboard/config-pattern", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.configPattern
-            }]
-    }));
-    server.resource("Dashboard Telemetry", "ftc://dashboard/telemetry", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.telemetry
-            }]
-    }));
-    server.resource("Dashboard Canvas", "ftc://dashboard/canvas", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.canvas
-            }]
-    }));
-    server.resource("Dashboard Camera", "ftc://dashboard/camera", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.camera
-            }]
-    }));
-    server.resource("Dashboard Setup", "ftc://dashboard/setup", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.setup
-            }]
-    }));
-    server.resource("Dashboard API", "ftc://dashboard/api", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: dashboard_js_1.DASHBOARD_KNOWLEDGE.api
-            }]
-    }));
-    // ── Gradle (GRADLE_KNOWLEDGE) ─────────────────────────────────────────
-    server.resource("Gradle Project Structure", "ftc://gradle/project-structure", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.projectStructure
-            }]
-    }));
-    server.resource("Adding Libraries", "ftc://gradle/adding-libraries", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.addingLibraries
-            }]
-    }));
-    server.resource("All Library Coordinates", "ftc://gradle/all-library-coords", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.allLibraryCoords
-            }]
-    }));
-    server.resource("Common Gradle Issues", "ftc://gradle/common-issues", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.commonIssues
-            }]
-    }));
-    server.resource("Build Process", "ftc://gradle/build-process", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.buildProcess
-            }]
-    }));
-    server.resource("Build and Deploy", "ftc://gradle/build-and-deploy", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: gradle_js_1.GRADLE_KNOWLEDGE.buildAndDeploy
-            }]
-    }));
-    // ── Hardware (HARDWARE_KNOWLEDGE) ─────────────────────────────────────
-    server.resource("Motors API", "ftc://hardware/motors/api", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.motorsApi
-            }]
-    }));
-    server.resource("Motor Run Modes", "ftc://hardware/motors/run-modes", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.motorRunModes
-            }]
-    }));
-    server.resource("Motor Specs", "ftc://hardware/motors/specs", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.motorSpecs
-            }]
-    }));
-    server.resource("Servos API", "ftc://hardware/servos/api", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.servosApi
-            }]
-    }));
-    server.resource("IMU Sensor", "ftc://hardware/sensors/imu", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.sensorsImu
-            }]
-    }));
-    server.resource("Distance Sensor", "ftc://hardware/sensors/distance", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.sensorsDistance
-            }]
-    }));
-    server.resource("Color Sensor", "ftc://hardware/sensors/color", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.sensorsColor
-            }]
-    }));
-    server.resource("Digital Sensors", "ftc://hardware/sensors/digital", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.sensorsDigital
-            }]
-    }));
-    server.resource("Encoders", "ftc://hardware/sensors/encoder", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.sensorsEncoder
-            }]
-    }));
-    server.resource("GoBilda Pinpoint", "ftc://hardware/pinpoint", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.pinpoint
-            }]
-    }));
-    server.resource("SparkFun OTOS", "ftc://hardware/otos", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.otos
-            }]
-    }));
-    server.resource("REV Hub", "ftc://hardware/rev-hub", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.revHub
-            }]
-    }));
-    server.resource("Bulk Reads", "ftc://hardware/bulk-reads", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.bulkReads
-            }]
-    }));
-    server.resource("Caching Hardware", "ftc://hardware/caching-hardware", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.cachingHardware
-            }]
-    }));
-    server.resource("Optimization Summary", "ftc://hardware/optimization-summary", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.optimizationSummary
-            }]
-    }));
-    server.resource("Custom Wrappers", "ftc://hardware/custom-wrappers", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.customWrappers
-            }]
-    }));
-    server.resource("Command Pipeline", "ftc://hardware/command-pipeline", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.commandPipeline
-            }]
-    }));
-    server.resource("Write Optimization", "ftc://hardware/write-optimization", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.writeOptimization
-            }]
-    }));
-    server.resource("Loop Time Budget", "ftc://hardware/loop-time-budget", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.loopTimeBudget
-            }]
-    }));
-    server.resource("Vision", "ftc://hardware/vision", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: hardware_js_1.HARDWARE_KNOWLEDGE.vision
-            }]
-    }));
-    // ── Road Runner (ROADRUNNER_KNOWLEDGE) ────────────────────────────────
-    server.resource("Road Runner API", "ftc://roadrunner/api-reference", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: roadrunner_js_1.ROADRUNNER_KNOWLEDGE.apiReference
-            }]
-    }));
-    // ── Command-Based / SolversLib (FTCLIB_KNOWLEDGE) ──────────────────────
-    server.resource("Command-Base Setup", "ftc://command-base/setup", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.setup
-            }]
-    }));
-    server.resource("Command-Base API", "ftc://command-base/api", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.apiReference
-            }]
-    }));
-    server.resource("Command-Base Subsystem Patterns", "ftc://command-base/subsystems", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.subsystemPatterns
-            }]
-    }));
-    server.resource("Command-Base Command Patterns", "ftc://command-base/commands", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.commandPatterns
-            }]
-    }));
-    server.resource("Command-Base Triggers & GamepadEx", "ftc://command-base/triggers", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.triggers
-            }]
-    }));
-    server.resource("Command-Base Project Organization", "ftc://command-base/organization", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.organization
-            }]
-    }));
-    server.resource("Command-Base Pedro Integration", "ftc://command-base/pedro-integration", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.pedroIntegration
-            }]
-    }));
-    server.resource("Command-Base SolversLib Extras", "ftc://command-base/extras", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: ftclib_js_1.FTCLIB_KNOWLEDGE.extras
-            }]
-    }));
-    // ── Vision (VISION_KNOWLEDGE) ─────────────────────────────────────────
-    server.resource("Vision Overview", "ftc://vision/overview", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.overview
-            }]
-    }));
-    server.resource("VisionPortal Setup", "ftc://vision/visionportal-setup", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.visionPortalSetup
-            }]
-    }));
-    server.resource("AprilTag Detection", "ftc://vision/apriltag-detection", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.aprilTagDetection
-            }]
-    }));
-    server.resource("Camera Controls", "ftc://vision/camera-controls", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.cameraControls
-            }]
-    }));
-    server.resource("Limelight 3A Guide", "ftc://vision/limelight", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.limelight
-            }]
-    }));
-    server.resource("MegaTag Localization", "ftc://vision/megatag", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.megaTag
-            }]
-    }));
-    server.resource("Color Detection", "ftc://vision/color-detection", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.colorDetection
-            }]
-    }));
-    server.resource("Vision Optimization", "ftc://vision/optimization", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.visionOptimization
-            }]
-    }));
-    server.resource("Multi-Camera Setup", "ftc://vision/multi-camera", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.multiCamera
-            }]
-    }));
-    server.resource("Vision Patterns", "ftc://vision/patterns", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: vision_js_1.VISION_KNOWLEDGE.visionPatterns
-            }]
-    }));
-    // ── Panels (PANELS_KNOWLEDGE) ─────────────────────────────────────────
-    server.resource("Panels Overview", "ftc://panels/overview", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.overview
-            }]
-    }));
-    server.resource("Panels Setup", "ftc://panels/setup", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.setup
-            }]
-    }));
-    server.resource("Panels Configurables", "ftc://panels/configurables", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.configurables
-            }]
-    }));
-    server.resource("Panels Telemetry", "ftc://panels/telemetry", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.telemetry
-            }]
-    }));
-    server.resource("Panels Field Drawing", "ftc://panels/field", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.field
-            }]
-    }));
-    server.resource("Panels Limelight", "ftc://panels/limelight", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.limelight
-            }]
-    }));
-    server.resource("Panels Plugins", "ftc://panels/plugins", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.plugins
-            }]
-    }));
-    server.resource("Panels Gamepads", "ftc://panels/gamepads", async (uri) => ({
-        contents: [{
-                uri: uri.href,
-                mimeType: "text/plain",
-                text: panels_js_1.PANELS_KNOWLEDGE.gamepads
-            }]
-    }));
+    for (const [category, catDef] of Object.entries(index_js_1.CATEGORIES)) {
+        server.resource(catDef.label, new mcp_js_1.ResourceTemplate(`ftc://${category}/{topic}`, {
+            list: async () => ({
+                resources: (0, index_js_1.listResources)(category).map(r => ({
+                    uri: r.uri,
+                    name: r.name,
+                    mimeType: "text/plain",
+                })),
+            }),
+        }), async (uri, { topic }) => {
+            const topicStr = Array.isArray(topic) ? topic[0] : topic;
+            const content = (0, index_js_1.getResource)(category, topicStr);
+            if (content) {
+                return {
+                    contents: [{
+                            uri: uri.href,
+                            mimeType: "text/plain",
+                            text: content,
+                        }],
+                };
+            }
+            // Topic not found — return available topics for this category
+            const available = (0, index_js_1.listResources)(category);
+            const topicList = available.map(r => `  - ${r.uri} (${r.name})`).join("\n");
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/plain",
+                        text: `Topic "${topicStr}" not found in ${category}.\n\nAvailable:\n${topicList}`,
+                    }],
+            };
+        });
+    }
 }

package/build/server.js

@@ -8,7 +8,7 @@ const registry_js_3 = require("./prompts/registry.js");
 function createServer() {
     const server = new mcp_js_1.McpServer({
         name: "ftc-mcp",
-        version: "1.0.0",
+        version: "1.1.0",
     });
     (0, registry_js_1.registerResources)(server);
     (0, registry_js_2.registerTools)(server);

package/build/tools/registry.d.ts

@@ -1,2 +1,15 @@
+/**
+ * MCP Tool Registration — Context-Optimized
+ *
+ * Inspired by Cloudflare's Code Mode approach to reducing context window usage:
+ * - Consolidated from 6 tools → 3 tools (fewer tool definitions in context)
+ * - Compressed descriptions (no enumerated value lists in schemas)
+ * - Progressive discovery (available options returned at runtime, not upfront)
+ *
+ * Tools:
+ *   1. scan_project     — merged scan_ftc_project + scan_hardware_config
+ *   2. search_knowledge — merged search_ftc_docs + get_ftc_example + get_hardware_reference
+ *   3. validate_ftc_code — same logic, shorter description
+ */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare function registerTools(server: McpServer): void;