@intrig/mcp 0.0.1 → 0.0.15-16

package/dist/app/intrig-mcp/src/instructions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP server instructions for Intrig.
+ * Clarifies CLI vs MCP scope and provides framework-specific setup guidance.
+ */
+export declare const SERVER_INSTRUCTIONS = "# Intrig MCP Server\n\n## Tool Scope\n\n**CLI (mutations)**: Project setup, configuration changes, code generation\n**MCP (discovery)**: Query generated SDK content, search endpoints/schemas, get documentation\n\nMCP is read-only. It queries the Intrig daemon but cannot modify projects.\n\n### CLI Responsibilities\n- `intrig init` - Initialize project\n- `intrig source add/remove` - Manage API sources\n- `intrig sync` - Download/update OpenAPI specs\n- `intrig generate` - Generate typed SDK code\n- `intrig daemon` - Start background service\n\n### MCP Capabilities\n- List registered projects\n- Get project details and sources\n- Search generated endpoints and schemas\n- Retrieve full documentation with types\n\n## Setup Workflow (CLI)\n\nFor new projects, guide users through these commands:\n\n```bash\nnpx intrig init                          # Create intrig.config.ts\nnpx intrig source add <name> <url>       # Add OpenAPI spec URL\nnpx intrig sync --all                    # Download all specs\nnpx intrig generate                      # Generate SDK\nnpx intrig daemon                        # Start daemon (optional, auto-starts)\n```\n\n## Troubleshooting\n\n**If search returns no results or project has no sources:**\n1. Verify sources exist: user should run `npx intrig source list`\n2. Sync schemas: `npx intrig sync --all`\n3. Regenerate SDK: `npx intrig generate`\n4. Restart daemon if needed: `npx intrig daemon --restart`\n\n**If daemon not running:**\nMCP tools auto-start the daemon, but if issues persist: `npx intrig daemon`\n\n## Framework Setup\n\n### React\n```bash\nnpm install @intrig/react\n```\n\n```tsx\n// App root\nimport { IntrigProvider } from '@intrig/react';\n\n<IntrigProvider>\n  <App />\n</IntrigProvider>\n```\n\nImports: `import { useGetUsers } from '@intrig/react/<source>/<operation>'`\n\n### Next.js\n```bash\nnpm install @intrig/next\n```\n\n```tsx\n// layout.tsx or _app.tsx\nimport { IntrigProvider } from '@intrig/next';\n\n<IntrigProvider>\n  {children}\n</IntrigProvider>\n```\n\nImports: `import { useGetUsers } from '@intrig/next/<source>/<operation>'`\n\nServer components can use generated fetch functions directly without hooks.\n\n### NestJS (Coming Soon)\nServer-side client generation for NestJS is planned.\n\n## MCP Tool Flow\n\nTypical discovery workflow:\n1. `list_projects` - Find Intrig projects\n2. `get_project` - Get sources for a project\n3. `search` - Find endpoints by keyword (e.g., \"user\", \"POST /orders\")\n4. `get_documentation` - Get full details with request/response types\n\nIf steps 2-4 return empty results, the SDK likely hasn't been generated. Guide users to run CLI commands above.\n";
+//# sourceMappingURL=instructions.d.ts.map

package/dist/app/intrig-mcp/src/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../../src/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,0nFA6F/B,CAAC"}

package/dist/app/intrig-mcp/src/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAuBnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CA+ErC;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAQjD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAwBnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAgFrC;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAQjD"}

package/dist/main.js

@@ -1337,6 +1337,102 @@ Use \`search\` with type="schema" to find current schema IDs.`
   }
 }
 
+// app/intrig-mcp/src/instructions.ts
+var SERVER_INSTRUCTIONS = `# Intrig MCP Server
+
+## Tool Scope
+
+**CLI (mutations)**: Project setup, configuration changes, code generation
+**MCP (discovery)**: Query generated SDK content, search endpoints/schemas, get documentation
+
+MCP is read-only. It queries the Intrig daemon but cannot modify projects.
+
+### CLI Responsibilities
+- \`intrig init\` - Initialize project
+- \`intrig source add/remove\` - Manage API sources
+- \`intrig sync\` - Download/update OpenAPI specs
+- \`intrig generate\` - Generate typed SDK code
+- \`intrig daemon\` - Start background service
+
+### MCP Capabilities
+- List registered projects
+- Get project details and sources
+- Search generated endpoints and schemas
+- Retrieve full documentation with types
+
+## Setup Workflow (CLI)
+
+For new projects, guide users through these commands:
+
+\`\`\`bash
+npx intrig init                          # Create intrig.config.ts
+npx intrig source add <name> <url>       # Add OpenAPI spec URL
+npx intrig sync --all                    # Download all specs
+npx intrig generate                      # Generate SDK
+npx intrig daemon                        # Start daemon (optional, auto-starts)
+\`\`\`
+
+## Troubleshooting
+
+**If search returns no results or project has no sources:**
+1. Verify sources exist: user should run \`npx intrig source list\`
+2. Sync schemas: \`npx intrig sync --all\`
+3. Regenerate SDK: \`npx intrig generate\`
+4. Restart daemon if needed: \`npx intrig daemon --restart\`
+
+**If daemon not running:**
+MCP tools auto-start the daemon, but if issues persist: \`npx intrig daemon\`
+
+## Framework Setup
+
+### React
+\`\`\`bash
+npm install @intrig/react
+\`\`\`
+
+\`\`\`tsx
+// App root
+import { IntrigProvider } from '@intrig/react';
+
+<IntrigProvider>
+  <App />
+</IntrigProvider>
+\`\`\`
+
+Imports: \`import { useGetUsers } from '@intrig/react/<source>/<operation>'\`
+
+### Next.js
+\`\`\`bash
+npm install @intrig/next
+\`\`\`
+
+\`\`\`tsx
+// layout.tsx or _app.tsx
+import { IntrigProvider } from '@intrig/next';
+
+<IntrigProvider>
+  {children}
+</IntrigProvider>
+\`\`\`
+
+Imports: \`import { useGetUsers } from '@intrig/next/<source>/<operation>'\`
+
+Server components can use generated fetch functions directly without hooks.
+
+### NestJS (Coming Soon)
+Server-side client generation for NestJS is planned.
+
+## MCP Tool Flow
+
+Typical discovery workflow:
+1. \`list_projects\` - Find Intrig projects
+2. \`get_project\` - Get sources for a project
+3. \`search\` - Find endpoints by keyword (e.g., "user", "POST /orders")
+4. \`get_documentation\` - Get full details with request/response types
+
+If steps 2-4 return empty results, the SDK likely hasn't been generated. Guide users to run CLI commands above.
+`;
+
 // app/intrig-mcp/src/mcp/server.ts
 var TOOLS = [
   listProjectsTool,
@@ -1353,7 +1449,8 @@ function createServer() {
     {
       capabilities: {
         tools: {}
-      }
+      },
+      instructions: SERVER_INSTRUCTIONS
     }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intrig/mcp",
-  "version": "0.0.1",
+  "version": "0.0.15-16",
   "description": "MCP server for Intrig - exposes API documentation and search capabilities to Claude Desktop and MCP-compatible IDEs",
   "type": "module",
   "main": "./dist/main.js",
@@ -45,7 +45,9 @@
     "name": "intrig-mcp",
     "sourceRoot": "app/intrig-mcp/src",
     "projectType": "application",
-    "tags": ["mcp-server"],
+    "tags": [
+      "mcp-server"
+    ],
     "targets": {
       "build": {
         "executor": "@nx/esbuild:esbuild",