@nerviq/cli 1.17.3 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/LICENSE +23 -23
  2. package/README.md +4 -4
  3. package/bin/cli.js +61 -274
  4. package/package.json +60 -60
  5. package/src/activity.js +1039 -1039
  6. package/src/adoption-advisor.js +299 -299
  7. package/src/aider/config-parser.js +166 -166
  8. package/src/aider/context.js +158 -158
  9. package/src/aider/deep-review.js +316 -316
  10. package/src/aider/domain-packs.js +303 -303
  11. package/src/aider/freshness.js +93 -93
  12. package/src/aider/governance.js +253 -253
  13. package/src/aider/interactive.js +334 -334
  14. package/src/aider/mcp-packs.js +329 -329
  15. package/src/aider/patch.js +214 -214
  16. package/src/aider/plans.js +186 -186
  17. package/src/aider/premium.js +360 -360
  18. package/src/aider/setup.js +404 -404
  19. package/src/aider/techniques.js +16 -16
  20. package/src/analyze.js +951 -951
  21. package/src/anti-patterns.js +485 -485
  22. package/src/audit/instruction-files.js +180 -180
  23. package/src/audit/recommendations.js +577 -577
  24. package/src/auto-suggest.js +154 -154
  25. package/src/badge.js +13 -13
  26. package/src/behavioral-drift.js +801 -801
  27. package/src/benchmark.js +67 -67
  28. package/src/catalog.js +103 -103
  29. package/src/certification.js +128 -128
  30. package/src/codex/config-parser.js +183 -183
  31. package/src/codex/context.js +223 -223
  32. package/src/codex/deep-review.js +493 -493
  33. package/src/codex/domain-packs.js +394 -394
  34. package/src/codex/freshness.js +84 -84
  35. package/src/codex/governance.js +192 -192
  36. package/src/codex/interactive.js +618 -618
  37. package/src/codex/mcp-packs.js +914 -914
  38. package/src/codex/patch.js +209 -209
  39. package/src/codex/plans.js +251 -251
  40. package/src/codex/premium.js +614 -614
  41. package/src/codex/setup.js +591 -591
  42. package/src/context.js +320 -320
  43. package/src/continuous-ops.js +681 -681
  44. package/src/copilot/activity.js +309 -309
  45. package/src/copilot/config-parser.js +280 -226
  46. package/src/copilot/context.js +218 -197
  47. package/src/copilot/deep-review.js +346 -346
  48. package/src/copilot/domain-packs.js +372 -372
  49. package/src/copilot/freshness.js +57 -57
  50. package/src/copilot/governance.js +222 -222
  51. package/src/copilot/interactive.js +406 -406
  52. package/src/copilot/mcp-packs.js +826 -826
  53. package/src/copilot/plans.js +253 -253
  54. package/src/copilot/premium.js +451 -451
  55. package/src/copilot/setup.js +488 -488
  56. package/src/copilot/techniques.js +219 -78
  57. package/src/cost-tracking.js +61 -61
  58. package/src/cursor/activity.js +301 -301
  59. package/src/cursor/config-parser.js +265 -265
  60. package/src/cursor/context.js +256 -256
  61. package/src/cursor/deep-review.js +334 -334
  62. package/src/cursor/domain-packs.js +368 -368
  63. package/src/cursor/freshness.js +65 -65
  64. package/src/cursor/governance.js +229 -229
  65. package/src/cursor/interactive.js +391 -391
  66. package/src/cursor/mcp-packs.js +828 -828
  67. package/src/cursor/plans.js +254 -254
  68. package/src/cursor/premium.js +469 -469
  69. package/src/cursor/setup.js +488 -488
  70. package/src/dashboard.js +493 -493
  71. package/src/deep-review.js +428 -428
  72. package/src/deprecation.js +98 -98
  73. package/src/diff-only.js +280 -280
  74. package/src/doctor.js +119 -119
  75. package/src/domain-pack-expansion.js +1033 -1033
  76. package/src/domain-packs.js +387 -387
  77. package/src/feedback.js +178 -178
  78. package/src/fix-engine.js +783 -0
  79. package/src/fix-prompts.js +122 -122
  80. package/src/formatters/sarif.js +115 -115
  81. package/src/freshness.js +74 -74
  82. package/src/gemini/config-parser.js +275 -275
  83. package/src/gemini/context.js +221 -221
  84. package/src/gemini/deep-review.js +559 -559
  85. package/src/gemini/domain-packs.js +393 -393
  86. package/src/gemini/freshness.js +66 -66
  87. package/src/gemini/governance.js +201 -201
  88. package/src/gemini/interactive.js +860 -860
  89. package/src/gemini/mcp-packs.js +915 -915
  90. package/src/gemini/plans.js +269 -269
  91. package/src/gemini/premium.js +760 -760
  92. package/src/gemini/setup.js +692 -692
  93. package/src/gemini/techniques.js +14 -14
  94. package/src/governance.js +72 -72
  95. package/src/harmony/add.js +68 -68
  96. package/src/harmony/advisor.js +333 -333
  97. package/src/harmony/canon.js +565 -565
  98. package/src/harmony/cli.js +591 -591
  99. package/src/harmony/drift.js +401 -401
  100. package/src/harmony/governance.js +313 -313
  101. package/src/harmony/memory.js +239 -239
  102. package/src/harmony/sync.js +475 -475
  103. package/src/harmony/watch.js +370 -370
  104. package/src/hook-validation.js +342 -342
  105. package/src/index.js +271 -271
  106. package/src/init.js +184 -184
  107. package/src/instruction-surfaces.js +185 -185
  108. package/src/integrations.js +144 -144
  109. package/src/interactive.js +118 -118
  110. package/src/locales/en.json +1 -1
  111. package/src/locales/es.json +1 -1
  112. package/src/mcp-packs.js +830 -830
  113. package/src/mcp-server.js +726 -726
  114. package/src/mcp-validation.js +337 -337
  115. package/src/nerviq-sync.json +7 -7
  116. package/src/opencode/config-parser.js +109 -109
  117. package/src/opencode/context.js +247 -247
  118. package/src/opencode/deep-review.js +313 -313
  119. package/src/opencode/domain-packs.js +262 -262
  120. package/src/opencode/freshness.js +66 -66
  121. package/src/opencode/governance.js +159 -159
  122. package/src/opencode/interactive.js +392 -392
  123. package/src/opencode/mcp-packs.js +705 -705
  124. package/src/opencode/patch.js +184 -184
  125. package/src/opencode/plans.js +231 -231
  126. package/src/opencode/premium.js +413 -413
  127. package/src/opencode/setup.js +449 -449
  128. package/src/opencode/techniques.js +27 -27
  129. package/src/operating-profile.js +574 -574
  130. package/src/org.js +152 -152
  131. package/src/permission-rules.js +218 -218
  132. package/src/plans.js +839 -839
  133. package/src/platform-change-manifest.js +86 -86
  134. package/src/plugins.js +110 -110
  135. package/src/policy-layers.js +210 -210
  136. package/src/profiles.js +124 -124
  137. package/src/prompt-injection.js +74 -74
  138. package/src/public-api.js +173 -173
  139. package/src/recommendation-rules.js +84 -84
  140. package/src/repo-archetype.js +386 -386
  141. package/src/secret-patterns.js +39 -39
  142. package/src/server.js +527 -527
  143. package/src/setup/analysis.js +607 -607
  144. package/src/setup/runtime.js +172 -172
  145. package/src/setup.js +677 -677
  146. package/src/shared/capabilities.js +194 -194
  147. package/src/source-urls.js +132 -132
  148. package/src/stack-checks.js +565 -565
  149. package/src/supplemental-checks.js +13 -13
  150. package/src/synergy/adaptive.js +261 -261
  151. package/src/synergy/compensation.js +137 -137
  152. package/src/synergy/evidence.js +193 -193
  153. package/src/synergy/learning.js +199 -199
  154. package/src/synergy/patterns.js +227 -227
  155. package/src/synergy/ranking.js +83 -83
  156. package/src/synergy/report.js +165 -165
  157. package/src/synergy/routing.js +146 -146
  158. package/src/techniques/api.js +407 -407
  159. package/src/techniques/automation.js +316 -316
  160. package/src/techniques/compliance.js +257 -257
  161. package/src/techniques/hygiene.js +294 -294
  162. package/src/techniques/instructions.js +243 -243
  163. package/src/techniques/observability.js +226 -226
  164. package/src/techniques/optimization.js +142 -142
  165. package/src/techniques/quality.js +318 -318
  166. package/src/techniques/security.js +237 -237
  167. package/src/techniques/shared.js +443 -443
  168. package/src/techniques/stacks.js +2294 -2294
  169. package/src/techniques/tools.js +106 -106
  170. package/src/techniques/workflow.js +413 -413
  171. package/src/techniques.js +81 -81
  172. package/src/terminology.js +73 -73
  173. package/src/token-estimate.js +35 -35
  174. package/src/usage-patterns.js +99 -99
  175. package/src/verification-metadata.js +145 -145
  176. package/src/watch.js +247 -247
  177. package/src/windsurf/activity.js +302 -302
  178. package/src/windsurf/config-parser.js +267 -267
  179. package/src/windsurf/context.js +249 -249
  180. package/src/windsurf/deep-review.js +337 -337
  181. package/src/windsurf/domain-packs.js +370 -370
  182. package/src/windsurf/freshness.js +36 -36
  183. package/src/windsurf/governance.js +231 -231
  184. package/src/windsurf/interactive.js +388 -388
  185. package/src/windsurf/mcp-packs.js +792 -792
  186. package/src/windsurf/plans.js +247 -247
  187. package/src/windsurf/premium.js +468 -468
  188. package/src/windsurf/setup.js +471 -471
  189. package/src/windsurf/techniques.js +17 -17
  190. package/src/workspace.js +375 -375
@@ -1,828 +1,828 @@
1
- /**
2
- * Cursor MCP Pack System
3
- *
4
- * 26 MCP packs with JSON-aware projection, detection,
5
- * recommendation, merge logic, and trust preflight.
6
- *
7
- * KEY DIFFERENCE: Cursor MCP uses .cursor/mcp.json format with
8
- * "mcpServers" wrapper (different from VS Code's .vscode/mcp.json "servers" wrapper).
9
- * Tool approval/auto-run model. Hard limit ~40 tools across all servers.
10
- *
11
- * .cursor/mcp.json format:
12
- * {
13
- * "mcpServers": {
14
- * "server-name": {
15
- * "command": "npx",
16
- * "args": [...],
17
- * "env": { "KEY": "${env:MY_KEY}" }
18
- * }
19
- * }
20
- * }
21
- */
22
-
23
- const CURSOR_MCP_PACKS = [
24
- {
25
- key: 'context7-docs',
26
- label: 'Context7 Docs',
27
- description: 'Live, current framework and library documentation during Cursor sessions.',
28
- useWhen: 'Repos that use any framework, library, or SDK and benefit from up-to-date docs.',
29
- adoption: 'Safe default docs pack for most application repos. No auth required.',
30
- trustLevel: 'high',
31
- transport: 'stdio',
32
- requiredAuth: [],
33
- serverName: 'context7',
34
- jsonProjection: { command: 'npx', args: ['-y', '@upstash/context7-mcp@latest'] },
35
- excludeTools: [],
36
- backgroundAgentCompatible: true,
37
- },
38
- {
39
- key: 'github-mcp',
40
- label: 'GitHub',
41
- description: 'Issue, PR, and repository context during Cursor sessions.',
42
- useWhen: 'Repos hosted on GitHub that benefit from issue, PR, and repo context.',
43
- adoption: 'Recommended for any GitHub-hosted project. Requires GITHUB_PERSONAL_ACCESS_TOKEN.',
44
- trustLevel: 'medium',
45
- transport: 'stdio',
46
- requiredAuth: ['GITHUB_PERSONAL_ACCESS_TOKEN'],
47
- serverName: 'github',
48
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-github'], env: { GITHUB_PERSONAL_ACCESS_TOKEN: '${env:GITHUB_PERSONAL_ACCESS_TOKEN}' } },
49
- excludeTools: ['create_repository', 'delete_file', 'push_files'],
50
- backgroundAgentCompatible: true,
51
- },
52
- {
53
- key: 'playwright-mcp',
54
- label: 'Playwright Browser',
55
- description: 'Browser automation, E2E testing, and visual QA.',
56
- useWhen: 'Frontend repos with E2E tests or browser-based workflows.',
57
- adoption: 'Recommended for frontend-ui repos with E2E tests. No auth required.',
58
- trustLevel: 'medium',
59
- transport: 'stdio',
60
- requiredAuth: [],
61
- serverName: 'playwright',
62
- jsonProjection: { command: 'npx', args: ['-y', '@playwright/mcp@latest'] },
63
- excludeTools: [],
64
- backgroundAgentCompatible: false, // Requires browser
65
- },
66
- {
67
- key: 'postgres-mcp',
68
- label: 'PostgreSQL',
69
- description: 'Schema inspection and query assistance for PostgreSQL databases.',
70
- useWhen: 'Repos with PostgreSQL databases that benefit from schema and query context.',
71
- adoption: 'Useful for backend-api and data-pipeline repos. Requires DATABASE_URL.',
72
- trustLevel: 'low',
73
- transport: 'stdio',
74
- requiredAuth: ['DATABASE_URL'],
75
- serverName: 'postgres',
76
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-postgres', '${env:DATABASE_URL}'] },
77
- excludeTools: ['execute_sql'],
78
- backgroundAgentCompatible: false, // Requires local DB
79
- },
80
- {
81
- key: 'memory-mcp',
82
- label: 'Memory / Knowledge Graph',
83
- description: 'Persistent entity and relationship tracking across Cursor sessions.',
84
- useWhen: 'Long-running or complex projects with many interconnected concepts.',
85
- adoption: 'Safe for any repo. Stores data locally. No auth required.',
86
- trustLevel: 'high',
87
- transport: 'stdio',
88
- requiredAuth: [],
89
- serverName: 'memory',
90
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-memory'] },
91
- excludeTools: [],
92
- backgroundAgentCompatible: false, // Ephemeral VM
93
- },
94
- {
95
- key: 'sequential-thinking',
96
- label: 'Sequential Thinking',
97
- description: 'Structured step-by-step reasoning for complex problem-solving.',
98
- useWhen: 'Complex problem-solving sessions that benefit from structured reasoning.',
99
- adoption: 'Safe default for any repo. No auth required.',
100
- trustLevel: 'high',
101
- transport: 'stdio',
102
- requiredAuth: [],
103
- serverName: 'sequential-thinking',
104
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-sequential-thinking'] },
105
- excludeTools: [],
106
- backgroundAgentCompatible: true,
107
- },
108
- {
109
- key: 'filesystem-mcp',
110
- label: 'Filesystem',
111
- description: 'Read-only filesystem access for documentation and reference files.',
112
- useWhen: 'Repos with reference files, docs, or config that Cursor needs to read.',
113
- adoption: 'Read-only default. Pass allowed directories as args.',
114
- trustLevel: 'medium',
115
- transport: 'stdio',
116
- requiredAuth: [],
117
- serverName: 'filesystem',
118
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '.'] },
119
- excludeTools: ['write_file', 'create_directory', 'move_file'],
120
- backgroundAgentCompatible: true,
121
- },
122
- {
123
- key: 'fetch-mcp',
124
- label: 'Fetch / HTTP',
125
- description: 'HTTP access for fetching web pages, APIs, and documentation.',
126
- useWhen: 'Repos that need HTTP access to external APIs or documentation sources.',
127
- adoption: 'Useful for repos integrating external services. No auth required.',
128
- trustLevel: 'medium',
129
- transport: 'stdio',
130
- requiredAuth: [],
131
- serverName: 'fetch',
132
- jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-fetch'] },
133
- excludeTools: [],
134
- backgroundAgentCompatible: true,
135
- },
136
- {
137
- key: 'next-devtools',
138
- label: 'Next.js Devtools',
139
- description: 'Runtime-aware debugging and framework-specific tooling for Next.js.',
140
- useWhen: 'Next.js repos that need runtime-aware debugging.',
141
- adoption: 'Useful companion for frontend-ui repos running Next.js.',
142
- trustLevel: 'medium',
143
- transport: 'stdio',
144
- requiredAuth: [],
145
- serverName: 'next-devtools',
146
- jsonProjection: { command: 'npx', args: ['-y', 'next-devtools-mcp@latest'] },
147
- excludeTools: [],
148
- backgroundAgentCompatible: false, // Requires local dev server
149
- },
150
- {
151
- key: 'docker-mcp',
152
- label: 'Docker',
153
- description: 'Container management during Cursor sessions.',
154
- useWhen: 'Repos with containerized workflows.',
155
- adoption: 'Requires Docker running locally.',
156
- trustLevel: 'medium',
157
- transport: 'stdio',
158
- requiredAuth: [],
159
- serverName: 'docker',
160
- jsonProjection: { command: 'npx', args: ['-y', '@hypnosis/docker-mcp-server'] },
161
- excludeTools: ['remove_container', 'remove_image'],
162
- backgroundAgentCompatible: false, // Requires local Docker
163
- },
164
- {
165
- key: 'notion-mcp',
166
- label: 'Notion',
167
- description: 'Access Notion documentation and wikis.',
168
- useWhen: 'Teams using Notion for docs or knowledge bases.',
169
- adoption: 'Requires NOTION_API_KEY.',
170
- trustLevel: 'medium',
171
- transport: 'stdio',
172
- requiredAuth: ['NOTION_API_KEY'],
173
- serverName: 'notion',
174
- jsonProjection: { command: 'npx', args: ['-y', '@notionhq/notion-mcp-server'], env: { NOTION_API_KEY: '${env:NOTION_API_KEY}' } },
175
- excludeTools: [],
176
- backgroundAgentCompatible: true,
177
- },
178
- {
179
- key: 'linear-mcp',
180
- label: 'Linear',
181
- description: 'Issue tracking and sprint context.',
182
- useWhen: 'Teams using Linear for issue tracking.',
183
- adoption: 'Requires LINEAR_API_KEY.',
184
- trustLevel: 'medium',
185
- transport: 'stdio',
186
- requiredAuth: ['LINEAR_API_KEY'],
187
- serverName: 'linear',
188
- jsonProjection: { command: 'npx', args: ['-y', '@mseep/linear-mcp'], env: { LINEAR_API_KEY: '${env:LINEAR_API_KEY}' } },
189
- excludeTools: [],
190
- backgroundAgentCompatible: true,
191
- },
192
- {
193
- key: 'sentry-mcp',
194
- label: 'Sentry',
195
- description: 'Error tracking and debugging context.',
196
- useWhen: 'Repos with Sentry error tracking.',
197
- adoption: 'Requires SENTRY_AUTH_TOKEN.',
198
- trustLevel: 'medium',
199
- transport: 'stdio',
200
- requiredAuth: ['SENTRY_AUTH_TOKEN'],
201
- serverName: 'sentry',
202
- jsonProjection: { command: 'npx', args: ['-y', '@sentry/mcp-server'], env: { SENTRY_AUTH_TOKEN: '${env:SENTRY_AUTH_TOKEN}' } },
203
- excludeTools: [],
204
- backgroundAgentCompatible: true,
205
- },
206
- {
207
- key: 'slack-mcp',
208
- label: 'Slack',
209
- description: 'Draft and preview Slack messages.',
210
- useWhen: 'Teams using Slack for communication.',
211
- adoption: 'Requires SLACK_BOT_TOKEN.',
212
- trustLevel: 'low',
213
- transport: 'stdio',
214
- requiredAuth: ['SLACK_BOT_TOKEN'],
215
- serverName: 'slack',
216
- jsonProjection: { command: 'npx', args: ['-y', 'slack-mcp-server'], env: { SLACK_BOT_TOKEN: '${env:SLACK_BOT_TOKEN}' } },
217
- excludeTools: ['delete_message'],
218
- backgroundAgentCompatible: true,
219
- },
220
- {
221
- key: 'stripe-mcp',
222
- label: 'Stripe',
223
- description: 'Payment and billing workflow context.',
224
- useWhen: 'Repos with Stripe integration.',
225
- adoption: 'Requires STRIPE_API_KEY.',
226
- trustLevel: 'low',
227
- transport: 'stdio',
228
- requiredAuth: ['STRIPE_API_KEY'],
229
- serverName: 'stripe',
230
- jsonProjection: { command: 'npx', args: ['-y', '@stripe/mcp'], env: { STRIPE_API_KEY: '${env:STRIPE_API_KEY}' } },
231
- excludeTools: ['create_charge', 'delete_customer'],
232
- backgroundAgentCompatible: true,
233
- },
234
- {
235
- key: 'figma-mcp',
236
- label: 'Figma',
237
- description: 'Design file access and component inspection.',
238
- useWhen: 'Design-heavy repos needing Figma access.',
239
- adoption: 'Requires FIGMA_ACCESS_TOKEN.',
240
- trustLevel: 'medium',
241
- transport: 'stdio',
242
- requiredAuth: ['FIGMA_ACCESS_TOKEN'],
243
- serverName: 'figma',
244
- jsonProjection: { command: 'npx', args: ['-y', 'claude-talk-to-figma-mcp'], env: { FIGMA_ACCESS_TOKEN: '${env:FIGMA_ACCESS_TOKEN}' } },
245
- excludeTools: [],
246
- backgroundAgentCompatible: false, // Requires OAuth
247
- },
248
- {
249
- key: 'mcp-security',
250
- label: 'MCP Security Scanner',
251
- description: 'Scan MCP servers for tool poisoning and prompt injection.',
252
- useWhen: 'Any repo with 2+ MCP servers.',
253
- adoption: 'Safety companion for multi-MCP setups. Critical given Cursor CVE history.',
254
- trustLevel: 'high',
255
- transport: 'stdio',
256
- requiredAuth: [],
257
- serverName: 'mcp-scan',
258
- jsonProjection: { command: 'npx', args: ['-y', 'mcp-scan@latest'] },
259
- excludeTools: [],
260
- backgroundAgentCompatible: true,
261
- },
262
- {
263
- key: 'composio-mcp',
264
- label: 'Composio Universal',
265
- description: '500+ integrations through a single MCP gateway.',
266
- useWhen: 'Enterprise or integration-heavy repos.',
267
- adoption: 'Requires COMPOSIO_API_KEY.',
268
- trustLevel: 'medium',
269
- transport: 'stdio',
270
- requiredAuth: ['COMPOSIO_API_KEY'],
271
- serverName: 'composio',
272
- jsonProjection: { command: 'npx', args: ['-y', '@composio/mcp'], env: { COMPOSIO_API_KEY: '${env:COMPOSIO_API_KEY}' } },
273
- excludeTools: [],
274
- backgroundAgentCompatible: true,
275
- },
276
- {
277
- key: 'jira-confluence',
278
- label: 'Jira',
279
- description: 'Issue tracking and project management.',
280
- useWhen: 'Teams using Atlassian Jira.',
281
- adoption: 'Requires ATLASSIAN_API_TOKEN and ATLASSIAN_EMAIL.',
282
- trustLevel: 'medium',
283
- transport: 'stdio',
284
- requiredAuth: ['ATLASSIAN_API_TOKEN', 'ATLASSIAN_EMAIL'],
285
- serverName: 'jira',
286
- jsonProjection: { command: 'npx', args: ['-y', 'jira-mcp'], env: { ATLASSIAN_API_TOKEN: '${env:ATLASSIAN_API_TOKEN}', ATLASSIAN_EMAIL: '${env:ATLASSIAN_EMAIL}' } },
287
- excludeTools: [],
288
- backgroundAgentCompatible: true,
289
- },
290
- {
291
- key: 'ga4-analytics',
292
- label: 'Google Analytics 4',
293
- description: 'Live GA4 data, attribution, and audience insights.',
294
- useWhen: 'Repos with web analytics needs.',
295
- adoption: 'Requires GA4_PROPERTY_ID and GOOGLE_APPLICATION_CREDENTIALS.',
296
- trustLevel: 'medium',
297
- transport: 'stdio',
298
- requiredAuth: ['GA4_PROPERTY_ID', 'GOOGLE_APPLICATION_CREDENTIALS'],
299
- serverName: 'ga4',
300
- jsonProjection: { command: 'npx', args: ['-y', 'mcp-server-ga4'], env: { GA4_PROPERTY_ID: '${env:GA4_PROPERTY_ID}', GOOGLE_APPLICATION_CREDENTIALS: '${env:GOOGLE_APPLICATION_CREDENTIALS}' } },
301
- excludeTools: [],
302
- backgroundAgentCompatible: false, // Requires OAuth
303
- },
304
- {
305
- key: 'search-console',
306
- label: 'Google Search Console',
307
- description: 'Search performance and indexing data.',
308
- useWhen: 'SEO-focused repos.',
309
- adoption: 'Requires Google OAuth credentials.',
310
- trustLevel: 'medium',
311
- transport: 'stdio',
312
- requiredAuth: ['GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET'],
313
- serverName: 'gsc',
314
- jsonProjection: { command: 'npx', args: ['-y', 'mcp-gsc@latest'], env: { GOOGLE_CLIENT_ID: '${env:GOOGLE_CLIENT_ID}', GOOGLE_CLIENT_SECRET: '${env:GOOGLE_CLIENT_SECRET}' } },
315
- excludeTools: [],
316
- backgroundAgentCompatible: false, // Requires OAuth
317
- },
318
- {
319
- key: 'n8n-workflows',
320
- label: 'n8n Workflow Automation',
321
- description: 'Workflow automation with 1,396 integration nodes.',
322
- useWhen: 'Teams using n8n for workflow automation.',
323
- adoption: 'Requires N8N_URL and N8N_API_KEY.',
324
- trustLevel: 'medium',
325
- transport: 'stdio',
326
- requiredAuth: ['N8N_URL', 'N8N_API_KEY'],
327
- serverName: 'n8n',
328
- jsonProjection: { command: 'npx', args: ['-y', 'n8n-mcp-server@latest'], env: { N8N_URL: '${env:N8N_URL}', N8N_API_KEY: '${env:N8N_API_KEY}' } },
329
- excludeTools: [],
330
- backgroundAgentCompatible: true,
331
- },
332
- {
333
- key: 'zendesk-mcp',
334
- label: 'Zendesk',
335
- description: 'Ticket management and help center content.',
336
- useWhen: 'Support teams using Zendesk.',
337
- adoption: 'Requires ZENDESK_API_TOKEN and ZENDESK_SUBDOMAIN.',
338
- trustLevel: 'medium',
339
- transport: 'stdio',
340
- requiredAuth: ['ZENDESK_API_TOKEN', 'ZENDESK_SUBDOMAIN'],
341
- serverName: 'zendesk',
342
- jsonProjection: { command: 'npx', args: ['-y', 'zendesk-mcp'], env: { ZENDESK_API_TOKEN: '${env:ZENDESK_API_TOKEN}', ZENDESK_SUBDOMAIN: '${env:ZENDESK_SUBDOMAIN}' } },
343
- excludeTools: [],
344
- backgroundAgentCompatible: true,
345
- },
346
- {
347
- key: 'infisical-secrets',
348
- label: 'Infisical Secrets',
349
- description: 'Secrets management with auto-rotation.',
350
- useWhen: 'Repos using Infisical for secrets.',
351
- adoption: 'Requires INFISICAL_TOKEN.',
352
- trustLevel: 'low',
353
- transport: 'stdio',
354
- requiredAuth: ['INFISICAL_TOKEN'],
355
- serverName: 'infisical',
356
- jsonProjection: { command: 'npx', args: ['-y', '@infisical/mcp'], env: { INFISICAL_TOKEN: '${env:INFISICAL_TOKEN}' } },
357
- excludeTools: ['delete_secret', 'update_secret'],
358
- backgroundAgentCompatible: true,
359
- },
360
- {
361
- key: 'shopify-mcp',
362
- label: 'Shopify',
363
- description: 'Shopify API and deployment tooling.',
364
- useWhen: 'Shopify stores and apps.',
365
- adoption: 'Requires SHOPIFY_ACCESS_TOKEN.',
366
- trustLevel: 'medium',
367
- transport: 'stdio',
368
- requiredAuth: ['SHOPIFY_ACCESS_TOKEN'],
369
- serverName: 'shopify',
370
- jsonProjection: { command: 'npx', args: ['-y', 'shopify-mcp'], env: { SHOPIFY_ACCESS_TOKEN: '${env:SHOPIFY_ACCESS_TOKEN}' } },
371
- excludeTools: [],
372
- backgroundAgentCompatible: true,
373
- },
374
- {
375
- key: 'huggingface-mcp',
376
- label: 'Hugging Face',
377
- description: 'Model search, dataset discovery, and Spaces.',
378
- useWhen: 'AI/ML repos needing model registry access.',
379
- adoption: 'Requires HF_TOKEN.',
380
- trustLevel: 'medium',
381
- transport: 'stdio',
382
- requiredAuth: ['HF_TOKEN'],
383
- serverName: 'huggingface',
384
- jsonProjection: { command: 'npx', args: ['-y', 'huggingface-mcp-server'], env: { HF_TOKEN: '${env:HF_TOKEN}' } },
385
- excludeTools: [],
386
- backgroundAgentCompatible: true,
387
- },
388
- // ── 23 new packs ─────────────────────────────────────────────────────────
389
- {
390
- key: 'supabase-mcp', label: 'Supabase',
391
- description: 'Database, auth, and storage access for Supabase projects.',
392
- useWhen: 'Repos using Supabase for database, auth, or storage.',
393
- adoption: 'Recommended for full-stack Supabase repos. Requires SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY.',
394
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY'],
395
- serverName: 'supabase',
396
- jsonProjection: { command: 'npx', args: ['-y', '@supabase/mcp-server-supabase@latest'], env: { SUPABASE_URL: '${env:SUPABASE_URL}', SUPABASE_SERVICE_ROLE_KEY: '${env:SUPABASE_SERVICE_ROLE_KEY}' } },
397
- excludeTools: ['delete_project', 'drop_table'], backgroundAgentCompatible: true,
398
- },
399
- {
400
- key: 'prisma-mcp', label: 'Prisma ORM',
401
- description: 'Schema inspection and migration management for Prisma.',
402
- useWhen: 'Repos using Prisma for database schema and migrations.',
403
- adoption: 'Recommended for any repo with a Prisma schema. Requires DATABASE_URL.',
404
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['DATABASE_URL'],
405
- serverName: 'prisma',
406
- jsonProjection: { command: 'npx', args: ['-y', 'prisma-mcp-server@latest'], env: { DATABASE_URL: '${env:DATABASE_URL}' } },
407
- excludeTools: ['drop_database'], backgroundAgentCompatible: false,
408
- },
409
- {
410
- key: 'vercel-mcp', label: 'Vercel',
411
- description: 'Deployment management and log access for Vercel projects.',
412
- useWhen: 'Repos deployed on Vercel.',
413
- adoption: 'Recommended for Vercel-hosted repos. Requires VERCEL_TOKEN.',
414
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['VERCEL_TOKEN'],
415
- serverName: 'vercel',
416
- jsonProjection: { command: 'npx', args: ['-y', '@vercel/mcp-server@latest'], env: { VERCEL_TOKEN: '${env:VERCEL_TOKEN}' } },
417
- excludeTools: ['delete_project', 'delete_deployment'], backgroundAgentCompatible: true,
418
- },
419
- {
420
- key: 'cloudflare-mcp', label: 'Cloudflare',
421
- description: 'Workers, KV, R2, and D1 management.',
422
- useWhen: 'Repos using Cloudflare Workers, KV, R2, or D1.',
423
- adoption: 'Recommended for edge-compute repos. Requires CLOUDFLARE_API_TOKEN.',
424
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CLOUDFLARE_API_TOKEN'],
425
- serverName: 'cloudflare',
426
- jsonProjection: { command: 'npx', args: ['-y', '@cloudflare/mcp-server-cloudflare@latest'], env: { CLOUDFLARE_API_TOKEN: '${env:CLOUDFLARE_API_TOKEN}' } },
427
- excludeTools: ['delete_worker', 'purge_cache'], backgroundAgentCompatible: true,
428
- },
429
- {
430
- key: 'aws-mcp', label: 'AWS',
431
- description: 'S3, Lambda, DynamoDB, and CloudFormation access.',
432
- useWhen: 'Repos using AWS cloud services.',
433
- adoption: 'Recommended for cloud-infra repos. Requires AWS credentials.',
434
- trustLevel: 'low', transport: 'stdio', requiredAuth: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_REGION'],
435
- serverName: 'aws',
436
- jsonProjection: { command: 'npx', args: ['-y', '@aws-samples/mcp-server-aws@latest'], env: { AWS_ACCESS_KEY_ID: '${env:AWS_ACCESS_KEY_ID}', AWS_SECRET_ACCESS_KEY: '${env:AWS_SECRET_ACCESS_KEY}', AWS_REGION: '${env:AWS_REGION}' } },
437
- excludeTools: ['delete_stack', 'terminate_instances', 'delete_bucket'], backgroundAgentCompatible: true,
438
- },
439
- {
440
- key: 'redis-mcp', label: 'Redis',
441
- description: 'Cache and session management via Redis.',
442
- useWhen: 'Repos using Redis for caching or sessions.',
443
- adoption: 'Recommended for performance-critical repos. Requires REDIS_URL.',
444
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['REDIS_URL'],
445
- serverName: 'redis',
446
- jsonProjection: { command: 'npx', args: ['-y', 'redis-mcp-server@latest'], env: { REDIS_URL: '${env:REDIS_URL}' } },
447
- excludeTools: ['flushall', 'flushdb'], backgroundAgentCompatible: true,
448
- },
449
- {
450
- key: 'mongodb-mcp', label: 'MongoDB',
451
- description: 'Document database access for MongoDB.',
452
- useWhen: 'Repos using MongoDB.',
453
- adoption: 'Recommended for document-model repos. Requires MONGODB_URI.',
454
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['MONGODB_URI'],
455
- serverName: 'mongodb',
456
- jsonProjection: { command: 'npx', args: ['-y', '@mongodb-js/mongodb-mcp-server@latest'], env: { MONGODB_URI: '${env:MONGODB_URI}' } },
457
- excludeTools: ['drop_collection', 'drop_database'], backgroundAgentCompatible: false,
458
- },
459
- {
460
- key: 'twilio-mcp', label: 'Twilio',
461
- description: 'SMS, voice, and messaging via Twilio.',
462
- useWhen: 'Repos using Twilio for communications.',
463
- adoption: 'Recommended for communication-feature repos. Requires TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN.',
464
- trustLevel: 'low', transport: 'stdio', requiredAuth: ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN'],
465
- serverName: 'twilio',
466
- jsonProjection: { command: 'npx', args: ['-y', 'twilio-mcp-server@latest'], env: { TWILIO_ACCOUNT_SID: '${env:TWILIO_ACCOUNT_SID}', TWILIO_AUTH_TOKEN: '${env:TWILIO_AUTH_TOKEN}' } },
467
- excludeTools: ['delete_message'], backgroundAgentCompatible: true,
468
- },
469
- {
470
- key: 'sendgrid-mcp', label: 'SendGrid',
471
- description: 'Transactional and marketing email via SendGrid.',
472
- useWhen: 'Repos using SendGrid for email delivery.',
473
- adoption: 'Recommended for repos with email workflows. Requires SENDGRID_API_KEY.',
474
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['SENDGRID_API_KEY'],
475
- serverName: 'sendgrid',
476
- jsonProjection: { command: 'npx', args: ['-y', 'sendgrid-mcp-server@latest'], env: { SENDGRID_API_KEY: '${env:SENDGRID_API_KEY}' } },
477
- excludeTools: [], backgroundAgentCompatible: true,
478
- },
479
- {
480
- key: 'algolia-mcp', label: 'Algolia Search',
481
- description: 'Search indexing and query management via Algolia.',
482
- useWhen: 'Repos using Algolia for search.',
483
- adoption: 'Recommended for content-heavy and e-commerce repos. Requires ALGOLIA_APP_ID and ALGOLIA_API_KEY.',
484
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['ALGOLIA_APP_ID', 'ALGOLIA_API_KEY'],
485
- serverName: 'algolia',
486
- jsonProjection: { command: 'npx', args: ['-y', 'algolia-mcp-server@latest'], env: { ALGOLIA_APP_ID: '${env:ALGOLIA_APP_ID}', ALGOLIA_API_KEY: '${env:ALGOLIA_API_KEY}' } },
487
- excludeTools: ['delete_index'], backgroundAgentCompatible: true,
488
- },
489
- {
490
- key: 'planetscale-mcp', label: 'PlanetScale',
491
- description: 'MySQL database management via PlanetScale.',
492
- useWhen: 'Repos using PlanetScale for serverless MySQL.',
493
- adoption: 'Recommended for MySQL-based repos on PlanetScale. Requires PLANETSCALE_TOKEN.',
494
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['PLANETSCALE_TOKEN'],
495
- serverName: 'planetscale',
496
- jsonProjection: { command: 'npx', args: ['-y', 'planetscale-mcp-server@latest'], env: { PLANETSCALE_TOKEN: '${env:PLANETSCALE_TOKEN}' } },
497
- excludeTools: ['delete_database'], backgroundAgentCompatible: true,
498
- },
499
- {
500
- key: 'neon-mcp', label: 'Neon Serverless Postgres',
501
- description: 'Serverless PostgreSQL management via Neon.',
502
- useWhen: 'Repos using Neon for serverless Postgres.',
503
- adoption: 'Recommended for serverless and edge Postgres repos. Requires NEON_API_KEY.',
504
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['NEON_API_KEY'],
505
- serverName: 'neon',
506
- jsonProjection: { command: 'npx', args: ['-y', '@neondatabase/mcp-server-neon@latest'], env: { NEON_API_KEY: '${env:NEON_API_KEY}' } },
507
- excludeTools: ['delete_project'], backgroundAgentCompatible: true,
508
- },
509
- {
510
- key: 'turso-mcp', label: 'Turso Edge SQLite',
511
- description: 'Distributed edge SQLite management via Turso.',
512
- useWhen: 'Repos using Turso for edge SQLite.',
513
- adoption: 'Recommended for edge and multi-region apps. Requires TURSO_DATABASE_URL and TURSO_AUTH_TOKEN.',
514
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['TURSO_DATABASE_URL', 'TURSO_AUTH_TOKEN'],
515
- serverName: 'turso',
516
- jsonProjection: { command: 'npx', args: ['-y', 'turso-mcp-server@latest'], env: { TURSO_DATABASE_URL: '${env:TURSO_DATABASE_URL}', TURSO_AUTH_TOKEN: '${env:TURSO_AUTH_TOKEN}' } },
517
- excludeTools: ['destroy_database'], backgroundAgentCompatible: true,
518
- },
519
- {
520
- key: 'upstash-mcp', label: 'Upstash (Redis + Kafka)',
521
- description: 'Serverless Redis, Kafka, and QStash via Upstash.',
522
- useWhen: 'Repos using Upstash for serverless caching or messaging.',
523
- adoption: 'Recommended for serverless apps. Requires UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN.',
524
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['UPSTASH_REDIS_REST_URL', 'UPSTASH_REDIS_REST_TOKEN'],
525
- serverName: 'upstash',
526
- jsonProjection: { command: 'npx', args: ['-y', '@upstash/mcp-server@latest'], env: { UPSTASH_REDIS_REST_URL: '${env:UPSTASH_REDIS_REST_URL}', UPSTASH_REDIS_REST_TOKEN: '${env:UPSTASH_REDIS_REST_TOKEN}' } },
527
- excludeTools: [], backgroundAgentCompatible: true,
528
- },
529
- {
530
- key: 'convex-mcp', label: 'Convex',
531
- description: 'Reactive backend-as-a-service management via Convex.',
532
- useWhen: 'Repos using Convex as reactive backend.',
533
- adoption: 'Recommended for real-time full-stack repos. Requires CONVEX_DEPLOYMENT.',
534
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CONVEX_DEPLOYMENT'],
535
- serverName: 'convex',
536
- jsonProjection: { command: 'npx', args: ['-y', '@convex-dev/mcp-server@latest'], env: { CONVEX_DEPLOYMENT: '${env:CONVEX_DEPLOYMENT}' } },
537
- excludeTools: ['delete_deployment'], backgroundAgentCompatible: true,
538
- },
539
- {
540
- key: 'clerk-mcp', label: 'Clerk Authentication',
541
- description: 'User auth and session management via Clerk.',
542
- useWhen: 'Repos using Clerk for authentication.',
543
- adoption: 'Recommended for SaaS repos with Clerk. Requires CLERK_SECRET_KEY.',
544
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CLERK_SECRET_KEY'],
545
- serverName: 'clerk',
546
- jsonProjection: { command: 'npx', args: ['-y', '@clerk/mcp-server@latest'], env: { CLERK_SECRET_KEY: '${env:CLERK_SECRET_KEY}' } },
547
- excludeTools: ['delete_user'], backgroundAgentCompatible: true,
548
- },
549
- {
550
- key: 'resend-mcp', label: 'Resend Email',
551
- description: 'Developer-focused transactional email via Resend.',
552
- useWhen: 'Repos using Resend for email.',
553
- adoption: 'Recommended for modern full-stack repos. Requires RESEND_API_KEY.',
554
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['RESEND_API_KEY'],
555
- serverName: 'resend',
556
- jsonProjection: { command: 'npx', args: ['-y', 'resend-mcp-server@latest'], env: { RESEND_API_KEY: '${env:RESEND_API_KEY}' } },
557
- excludeTools: [], backgroundAgentCompatible: true,
558
- },
559
- {
560
- key: 'temporal-mcp', label: 'Temporal Workflow',
561
- description: 'Durable workflow orchestration via Temporal.',
562
- useWhen: 'Repos using Temporal for workflows.',
563
- adoption: 'Recommended for async-workflow and microservice repos. Requires TEMPORAL_ADDRESS.',
564
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['TEMPORAL_ADDRESS'],
565
- serverName: 'temporal',
566
- jsonProjection: { command: 'npx', args: ['-y', 'temporal-mcp-server@latest'], env: { TEMPORAL_ADDRESS: '${env:TEMPORAL_ADDRESS}' } },
567
- excludeTools: ['terminate_workflow'], backgroundAgentCompatible: true,
568
- },
569
- {
570
- key: 'launchdarkly-mcp', label: 'LaunchDarkly',
571
- description: 'Feature flags and experimentation via LaunchDarkly.',
572
- useWhen: 'Repos using LaunchDarkly for feature flags.',
573
- adoption: 'Recommended for feature-flag-driven development. Requires LAUNCHDARKLY_ACCESS_TOKEN.',
574
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['LAUNCHDARKLY_ACCESS_TOKEN'],
575
- serverName: 'launchdarkly',
576
- jsonProjection: { command: 'npx', args: ['-y', 'launchdarkly-mcp-server@latest'], env: { LAUNCHDARKLY_ACCESS_TOKEN: '${env:LAUNCHDARKLY_ACCESS_TOKEN}' } },
577
- excludeTools: ['delete_flag'], backgroundAgentCompatible: true,
578
- },
579
- {
580
- key: 'datadog-mcp', label: 'Datadog',
581
- description: 'Monitoring, APM, and log management via Datadog.',
582
- useWhen: 'Repos using Datadog for observability.',
583
- adoption: 'Recommended for production repos. Requires DATADOG_API_KEY and DATADOG_APP_KEY.',
584
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['DATADOG_API_KEY', 'DATADOG_APP_KEY'],
585
- serverName: 'datadog',
586
- jsonProjection: { command: 'npx', args: ['-y', '@datadog/mcp-server@latest'], env: { DATADOG_API_KEY: '${env:DATADOG_API_KEY}', DATADOG_APP_KEY: '${env:DATADOG_APP_KEY}' } },
587
- excludeTools: ['delete_monitor'], backgroundAgentCompatible: true,
588
- },
589
- {
590
- key: 'grafana-mcp', label: 'Grafana',
591
- description: 'Dashboard and observability access via Grafana.',
592
- useWhen: 'Repos using Grafana for dashboards.',
593
- adoption: 'Recommended for observability-focused repos. Requires GRAFANA_URL and GRAFANA_API_KEY.',
594
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['GRAFANA_URL', 'GRAFANA_API_KEY'],
595
- serverName: 'grafana',
596
- jsonProjection: { command: 'npx', args: ['-y', 'grafana-mcp-server@latest'], env: { GRAFANA_URL: '${env:GRAFANA_URL}', GRAFANA_API_KEY: '${env:GRAFANA_API_KEY}' } },
597
- excludeTools: ['delete_dashboard'], backgroundAgentCompatible: true,
598
- },
599
- {
600
- key: 'circleci-mcp', label: 'CircleCI',
601
- description: 'CI/CD pipeline access via CircleCI.',
602
- useWhen: 'Repos using CircleCI for CI/CD.',
603
- adoption: 'Recommended for CircleCI-powered projects. Requires CIRCLECI_TOKEN.',
604
- trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CIRCLECI_TOKEN'],
605
- serverName: 'circleci',
606
- jsonProjection: { command: 'npx', args: ['-y', 'circleci-mcp-server@latest'], env: { CIRCLECI_TOKEN: '${env:CIRCLECI_TOKEN}' } },
607
- excludeTools: ['cancel_pipeline'], backgroundAgentCompatible: true,
608
- },
609
- {
610
- key: 'anthropic-mcp', label: 'Anthropic Claude API',
611
- description: 'Claude API access for AI-powered apps.',
612
- useWhen: 'Repos building on the Anthropic Claude API.',
613
- adoption: 'Recommended for AI-powered apps using Claude. Requires ANTHROPIC_API_KEY.',
614
- trustLevel: 'high', transport: 'stdio', requiredAuth: ['ANTHROPIC_API_KEY'],
615
- serverName: 'anthropic',
616
- jsonProjection: { command: 'npx', args: ['-y', '@anthropic-ai/mcp-server@latest'], env: { ANTHROPIC_API_KEY: '${env:ANTHROPIC_API_KEY}' } },
617
- excludeTools: [], backgroundAgentCompatible: true,
618
- },
619
- ];
620
-
621
- // --- Helpers ---
622
-
623
- function clone(value) {
624
- return JSON.parse(JSON.stringify(value));
625
- }
626
-
627
- function hasDependency(deps, name) {
628
- return Object.prototype.hasOwnProperty.call(deps || {}, name);
629
- }
630
-
631
- function hasFileContentMatch(ctx, filePath, pattern) {
632
- if (!ctx) return false;
633
- const content = ctx.fileContent(filePath);
634
- return !!(content && pattern.test(content));
635
- }
636
-
637
- function getProjectDependencies(ctx) {
638
- if (!ctx) return {};
639
- if (typeof ctx.projectDependencies === 'function') return ctx.projectDependencies();
640
- const pkg = ctx.jsonFile('package.json') || {};
641
- return { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
642
- }
643
-
644
- function hasPostgresSignals(ctx, deps) {
645
- if (hasDependency(deps, 'pg') || hasDependency(deps, 'postgres') || hasDependency(deps, 'pg-promise') ||
646
- hasDependency(deps, 'slonik') || hasDependency(deps, '@neondatabase/serverless') || hasDependency(deps, '@vercel/postgres')) {
647
- return true;
648
- }
649
- return (
650
- hasFileContentMatch(ctx, 'prisma/schema.prisma', /provider\s*=\s*["']postgresql["']/i) ||
651
- hasFileContentMatch(ctx, 'docker-compose.yml', /\bpostgres\b/i) ||
652
- hasFileContentMatch(ctx, 'docker-compose.yaml', /\bpostgres\b/i)
653
- );
654
- }
655
-
656
- // --- Core Functions ---
657
-
658
- function getCursorMcpPack(key) {
659
- return CURSOR_MCP_PACKS.find(pack => pack.key === key) || null;
660
- }
661
-
662
- function normalizeCursorMcpPackKeys(keys = []) {
663
- return [...new Set((Array.isArray(keys) ? keys : [])
664
- .map(key => `${key}`.trim())
665
- .filter(Boolean))]
666
- .filter(key => !!getCursorMcpPack(key));
667
- }
668
-
669
- /**
670
- * Generate .cursor/mcp.json entry for a single MCP pack.
671
- * Cursor uses .cursor/mcp.json with "mcpServers" wrapper.
672
- */
673
- function packToJson(pack) {
674
- const entry = {};
675
- const proj = pack.jsonProjection;
676
-
677
- if (proj.command) entry.command = proj.command;
678
- if (proj.url) entry.url = proj.url;
679
- if (proj.args && proj.args.length > 0) entry.args = [...proj.args];
680
- if (proj.env && Object.keys(proj.env).length > 0) entry.env = { ...proj.env };
681
-
682
- return { [pack.serverName]: entry };
683
- }
684
-
685
- /**
686
- * Detect which MCP packs to recommend for a Cursor project.
687
- */
688
- function recommendCursorMcpPacks(stacks = [], domainPacks = [], options = {}) {
689
- const recommended = new Set();
690
- const stackKeys = new Set(stacks.map(s => s.key));
691
- const ctx = options.ctx || null;
692
- const deps = getProjectDependencies(ctx);
693
- const domainKeys = new Set(domainPacks.map(p => p.key));
694
- const backgroundOnly = options.backgroundOnly === true;
695
-
696
- if (stackKeys.size > 0) recommended.add('context7-docs');
697
- if (domainKeys.has('enterprise-governed') || domainKeys.has('monorepo')) recommended.add('github-mcp');
698
-
699
- if (domainKeys.has('frontend-ui') || stackKeys.has('react') || stackKeys.has('nextjs') ||
700
- stackKeys.has('vue') || stackKeys.has('angular') || stackKeys.has('svelte')) {
701
- recommended.add('playwright-mcp');
702
- }
703
-
704
- if (stackKeys.has('nextjs') || hasDependency(deps, 'next')) recommended.add('next-devtools');
705
-
706
- if ((domainKeys.has('backend-api') || domainKeys.has('infra-platform')) && hasPostgresSignals(ctx, deps)) {
707
- recommended.add('postgres-mcp');
708
- }
709
-
710
- if (domainKeys.has('monorepo') || domainKeys.has('enterprise-governed')) recommended.add('memory-mcp');
711
- if (domainKeys.has('enterprise-governed') || domainKeys.has('monorepo') || domainKeys.has('infra-platform')) recommended.add('sequential-thinking');
712
- if (domainKeys.has('infra-platform')) recommended.add('filesystem-mcp');
713
-
714
- if (domainKeys.has('backend-api') && ctx && (hasDependency(deps, 'axios') || hasDependency(deps, 'node-fetch') || hasDependency(deps, 'got'))) {
715
- recommended.add('fetch-mcp');
716
- }
717
-
718
- if (domainKeys.has('infra-platform') || domainKeys.has('devops-cicd')) recommended.add('docker-mcp');
719
- if (domainKeys.has('ecommerce') && (hasDependency(deps, 'stripe') || hasDependency(deps, '@stripe/stripe-js'))) recommended.add('stripe-mcp');
720
- if (domainKeys.has('ecommerce') && (hasDependency(deps, 'shopify') || hasDependency(deps, '@shopify/shopify-api'))) recommended.add('shopify-mcp');
721
- if (domainKeys.has('ai-ml')) recommended.add('huggingface-mcp');
722
- if (domainKeys.has('design-system')) recommended.add('figma-mcp');
723
- // ── 23 new packs recommendation logic ────────────────────────────────────
724
- if (ctx) {
725
- if (hasDependency(deps, '@supabase/supabase-js') || hasDependency(deps, '@supabase/auth-helpers-nextjs') || hasFileContentMatch(ctx, '.env', /SUPABASE/i) || hasFileContentMatch(ctx, '.env.example', /SUPABASE/i)) recommended.add('supabase-mcp');
726
- if (hasFileContentMatch(ctx, 'schema.prisma', /\S/) || hasDependency(deps, '@prisma/client') || hasDependency(deps, 'prisma')) recommended.add('prisma-mcp');
727
- if (ctx.files.includes('vercel.json') || hasFileContentMatch(ctx, 'package.json', /"deploy":\s*"vercel/i) || hasFileContentMatch(ctx, '.env', /VERCEL_TOKEN/i)) recommended.add('vercel-mcp');
728
- if (hasFileContentMatch(ctx, 'wrangler.toml', /\S/) || hasDependency(deps, 'wrangler') || hasFileContentMatch(ctx, '.env', /CLOUDFLARE/i)) recommended.add('cloudflare-mcp');
729
- if (hasFileContentMatch(ctx, '.env', /AWS_ACCESS_KEY/i) || ctx.files.some(f => /serverless\.yml|template\.ya?ml|cdk\.json/.test(f))) recommended.add('aws-mcp');
730
- if (hasDependency(deps, 'redis') || hasDependency(deps, 'ioredis') || hasDependency(deps, '@redis/client') || hasFileContentMatch(ctx, '.env', /REDIS_URL/i)) recommended.add('redis-mcp');
731
- if (hasDependency(deps, 'mongoose') || hasDependency(deps, 'mongodb') || hasFileContentMatch(ctx, '.env', /MONGODB_URI/i)) recommended.add('mongodb-mcp');
732
- if (hasDependency(deps, 'twilio') || hasFileContentMatch(ctx, '.env', /TWILIO_/i)) recommended.add('twilio-mcp');
733
- if (hasDependency(deps, '@sendgrid/mail') || hasFileContentMatch(ctx, '.env', /SENDGRID_API_KEY/i)) recommended.add('sendgrid-mcp');
734
- if (hasDependency(deps, 'algoliasearch') || hasDependency(deps, '@algolia/client-search') || hasFileContentMatch(ctx, '.env', /ALGOLIA_/i)) recommended.add('algolia-mcp');
735
- if (hasFileContentMatch(ctx, '.env', /PLANETSCALE_TOKEN/i)) recommended.add('planetscale-mcp');
736
- if (hasDependency(deps, '@neondatabase/serverless') || hasFileContentMatch(ctx, '.env', /NEON_/i)) recommended.add('neon-mcp');
737
- if (hasDependency(deps, '@libsql/client') || hasFileContentMatch(ctx, '.env', /TURSO_/i)) recommended.add('turso-mcp');
738
- if (hasDependency(deps, '@upstash/redis') || hasDependency(deps, '@upstash/kafka') || hasFileContentMatch(ctx, '.env', /UPSTASH_/i)) recommended.add('upstash-mcp');
739
- if (hasDependency(deps, 'convex') || hasFileContentMatch(ctx, 'convex.json', /\S/) || hasFileContentMatch(ctx, '.env', /CONVEX_/i)) recommended.add('convex-mcp');
740
- if (hasDependency(deps, '@clerk/nextjs') || hasDependency(deps, '@clerk/backend') || hasFileContentMatch(ctx, '.env', /CLERK_/i)) recommended.add('clerk-mcp');
741
- if (hasDependency(deps, 'resend') || hasFileContentMatch(ctx, '.env', /RESEND_API_KEY/i)) recommended.add('resend-mcp');
742
- if (hasDependency(deps, '@temporalio/client') || hasFileContentMatch(ctx, '.env', /TEMPORAL_/i)) recommended.add('temporal-mcp');
743
- if (hasDependency(deps, '@launchdarkly/node-server-sdk') || hasFileContentMatch(ctx, '.env', /LAUNCHDARKLY_/i)) recommended.add('launchdarkly-mcp');
744
- if (hasDependency(deps, 'dd-trace') || hasFileContentMatch(ctx, '.env', /DATADOG_/i)) recommended.add('datadog-mcp');
745
- if (hasFileContentMatch(ctx, 'docker-compose.yml', /grafana/i) || hasFileContentMatch(ctx, '.env', /GRAFANA_/i)) recommended.add('grafana-mcp');
746
- if (ctx.files.some(f => /\.circleci\/config/.test(f)) || hasFileContentMatch(ctx, '.env', /CIRCLECI_/i)) recommended.add('circleci-mcp');
747
- if (hasDependency(deps, '@anthropic-ai/sdk') || hasDependency(deps, 'anthropic') || hasFileContentMatch(ctx, '.env', /ANTHROPIC_API_KEY/i)) recommended.add('anthropic-mcp');
748
- }
749
- if (recommended.size >= 2) recommended.add('mcp-security');
750
- if (recommended.size === 0) recommended.add('context7-docs');
751
-
752
- let result = CURSOR_MCP_PACKS.filter(pack => recommended.has(pack.key)).map(pack => clone(pack));
753
-
754
- // Filter out background-incompatible packs if targeting background agents
755
- if (backgroundOnly) {
756
- result = result.filter(pack => pack.backgroundAgentCompatible !== false);
757
- }
758
-
759
- return result;
760
- }
761
-
762
- /**
763
- * Trust preflight: check if packs are safe to install.
764
- */
765
- function getCursorMcpPreflight(packKeys = [], env = process.env) {
766
- return normalizeCursorMcpPackKeys(packKeys)
767
- .map(key => {
768
- const pack = getCursorMcpPack(key);
769
- if (!pack) return null;
770
- const missingEnvVars = pack.requiredAuth.filter(envKey => {
771
- const value = env && Object.prototype.hasOwnProperty.call(env, envKey) ? env[envKey] : '';
772
- return !`${value || ''}`.trim();
773
- });
774
- return {
775
- key,
776
- label: pack.label,
777
- trustLevel: pack.trustLevel,
778
- transport: pack.transport,
779
- requiredAuth: pack.requiredAuth,
780
- missingEnvVars,
781
- safe: missingEnvVars.length === 0,
782
- backgroundAgentCompatible: pack.backgroundAgentCompatible,
783
- warning: missingEnvVars.length > 0
784
- ? `Missing env vars: ${missingEnvVars.join(', ')}. Pack will be included but may fail at runtime.`
785
- : null,
786
- };
787
- })
788
- .filter(Boolean);
789
- }
790
-
791
- /**
792
- * Merge MCP packs into existing .cursor/mcp.json content.
793
- * Uses "mcpServers" wrapper format (Cursor-specific).
794
- */
795
- function mergeCursorMcpJson(existingContent = {}, packKeys = []) {
796
- let settings;
797
- if (typeof existingContent === 'string') {
798
- try { settings = JSON.parse(existingContent); } catch { settings = {}; }
799
- } else {
800
- settings = clone(existingContent);
801
- }
802
-
803
- if (!settings.mcpServers || typeof settings.mcpServers !== 'object') {
804
- settings.mcpServers = {};
805
- }
806
-
807
- const existingServers = new Set(Object.keys(settings.mcpServers));
808
- const newPacks = normalizeCursorMcpPackKeys(packKeys)
809
- .map(key => getCursorMcpPack(key))
810
- .filter(pack => pack && !existingServers.has(pack.serverName));
811
-
812
- for (const pack of newPacks) {
813
- const entry = packToJson(pack);
814
- const serverName = Object.keys(entry)[0];
815
- settings.mcpServers[serverName] = entry[serverName];
816
- }
817
-
818
- return settings;
819
- }
820
-
821
- module.exports = {
822
- CURSOR_MCP_PACKS,
823
- getCursorMcpPack,
824
- recommendCursorMcpPacks,
825
- getCursorMcpPreflight,
826
- mergeCursorMcpJson,
827
- packToJson,
828
- };
1
+ /**
2
+ * Cursor MCP Pack System
3
+ *
4
+ * 26 MCP packs with JSON-aware projection, detection,
5
+ * recommendation, merge logic, and trust preflight.
6
+ *
7
+ * KEY DIFFERENCE: Cursor MCP uses .cursor/mcp.json format with
8
+ * "mcpServers" wrapper (different from VS Code's .vscode/mcp.json "servers" wrapper).
9
+ * Tool approval/auto-run model. Hard limit ~40 tools across all servers.
10
+ *
11
+ * .cursor/mcp.json format:
12
+ * {
13
+ * "mcpServers": {
14
+ * "server-name": {
15
+ * "command": "npx",
16
+ * "args": [...],
17
+ * "env": { "KEY": "${env:MY_KEY}" }
18
+ * }
19
+ * }
20
+ * }
21
+ */
22
+
23
+ const CURSOR_MCP_PACKS = [
24
+ {
25
+ key: 'context7-docs',
26
+ label: 'Context7 Docs',
27
+ description: 'Live, current framework and library documentation during Cursor sessions.',
28
+ useWhen: 'Repos that use any framework, library, or SDK and benefit from up-to-date docs.',
29
+ adoption: 'Safe default docs pack for most application repos. No auth required.',
30
+ trustLevel: 'high',
31
+ transport: 'stdio',
32
+ requiredAuth: [],
33
+ serverName: 'context7',
34
+ jsonProjection: { command: 'npx', args: ['-y', '@upstash/context7-mcp@latest'] },
35
+ excludeTools: [],
36
+ backgroundAgentCompatible: true,
37
+ },
38
+ {
39
+ key: 'github-mcp',
40
+ label: 'GitHub',
41
+ description: 'Issue, PR, and repository context during Cursor sessions.',
42
+ useWhen: 'Repos hosted on GitHub that benefit from issue, PR, and repo context.',
43
+ adoption: 'Recommended for any GitHub-hosted project. Requires GITHUB_PERSONAL_ACCESS_TOKEN.',
44
+ trustLevel: 'medium',
45
+ transport: 'stdio',
46
+ requiredAuth: ['GITHUB_PERSONAL_ACCESS_TOKEN'],
47
+ serverName: 'github',
48
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-github'], env: { GITHUB_PERSONAL_ACCESS_TOKEN: '${env:GITHUB_PERSONAL_ACCESS_TOKEN}' } },
49
+ excludeTools: ['create_repository', 'delete_file', 'push_files'],
50
+ backgroundAgentCompatible: true,
51
+ },
52
+ {
53
+ key: 'playwright-mcp',
54
+ label: 'Playwright Browser',
55
+ description: 'Browser automation, E2E testing, and visual QA.',
56
+ useWhen: 'Frontend repos with E2E tests or browser-based workflows.',
57
+ adoption: 'Recommended for frontend-ui repos with E2E tests. No auth required.',
58
+ trustLevel: 'medium',
59
+ transport: 'stdio',
60
+ requiredAuth: [],
61
+ serverName: 'playwright',
62
+ jsonProjection: { command: 'npx', args: ['-y', '@playwright/mcp@latest'] },
63
+ excludeTools: [],
64
+ backgroundAgentCompatible: false, // Requires browser
65
+ },
66
+ {
67
+ key: 'postgres-mcp',
68
+ label: 'PostgreSQL',
69
+ description: 'Schema inspection and query assistance for PostgreSQL databases.',
70
+ useWhen: 'Repos with PostgreSQL databases that benefit from schema and query context.',
71
+ adoption: 'Useful for backend-api and data-pipeline repos. Requires DATABASE_URL.',
72
+ trustLevel: 'low',
73
+ transport: 'stdio',
74
+ requiredAuth: ['DATABASE_URL'],
75
+ serverName: 'postgres',
76
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-postgres', '${env:DATABASE_URL}'] },
77
+ excludeTools: ['execute_sql'],
78
+ backgroundAgentCompatible: false, // Requires local DB
79
+ },
80
+ {
81
+ key: 'memory-mcp',
82
+ label: 'Memory / Knowledge Graph',
83
+ description: 'Persistent entity and relationship tracking across Cursor sessions.',
84
+ useWhen: 'Long-running or complex projects with many interconnected concepts.',
85
+ adoption: 'Safe for any repo. Stores data locally. No auth required.',
86
+ trustLevel: 'high',
87
+ transport: 'stdio',
88
+ requiredAuth: [],
89
+ serverName: 'memory',
90
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-memory'] },
91
+ excludeTools: [],
92
+ backgroundAgentCompatible: false, // Ephemeral VM
93
+ },
94
+ {
95
+ key: 'sequential-thinking',
96
+ label: 'Sequential Thinking',
97
+ description: 'Structured step-by-step reasoning for complex problem-solving.',
98
+ useWhen: 'Complex problem-solving sessions that benefit from structured reasoning.',
99
+ adoption: 'Safe default for any repo. No auth required.',
100
+ trustLevel: 'high',
101
+ transport: 'stdio',
102
+ requiredAuth: [],
103
+ serverName: 'sequential-thinking',
104
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-sequential-thinking'] },
105
+ excludeTools: [],
106
+ backgroundAgentCompatible: true,
107
+ },
108
+ {
109
+ key: 'filesystem-mcp',
110
+ label: 'Filesystem',
111
+ description: 'Read-only filesystem access for documentation and reference files.',
112
+ useWhen: 'Repos with reference files, docs, or config that Cursor needs to read.',
113
+ adoption: 'Read-only default. Pass allowed directories as args.',
114
+ trustLevel: 'medium',
115
+ transport: 'stdio',
116
+ requiredAuth: [],
117
+ serverName: 'filesystem',
118
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '.'] },
119
+ excludeTools: ['write_file', 'create_directory', 'move_file'],
120
+ backgroundAgentCompatible: true,
121
+ },
122
+ {
123
+ key: 'fetch-mcp',
124
+ label: 'Fetch / HTTP',
125
+ description: 'HTTP access for fetching web pages, APIs, and documentation.',
126
+ useWhen: 'Repos that need HTTP access to external APIs or documentation sources.',
127
+ adoption: 'Useful for repos integrating external services. No auth required.',
128
+ trustLevel: 'medium',
129
+ transport: 'stdio',
130
+ requiredAuth: [],
131
+ serverName: 'fetch',
132
+ jsonProjection: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-fetch'] },
133
+ excludeTools: [],
134
+ backgroundAgentCompatible: true,
135
+ },
136
+ {
137
+ key: 'next-devtools',
138
+ label: 'Next.js Devtools',
139
+ description: 'Runtime-aware debugging and framework-specific tooling for Next.js.',
140
+ useWhen: 'Next.js repos that need runtime-aware debugging.',
141
+ adoption: 'Useful companion for frontend-ui repos running Next.js.',
142
+ trustLevel: 'medium',
143
+ transport: 'stdio',
144
+ requiredAuth: [],
145
+ serverName: 'next-devtools',
146
+ jsonProjection: { command: 'npx', args: ['-y', 'next-devtools-mcp@latest'] },
147
+ excludeTools: [],
148
+ backgroundAgentCompatible: false, // Requires local dev server
149
+ },
150
+ {
151
+ key: 'docker-mcp',
152
+ label: 'Docker',
153
+ description: 'Container management during Cursor sessions.',
154
+ useWhen: 'Repos with containerized workflows.',
155
+ adoption: 'Requires Docker running locally.',
156
+ trustLevel: 'medium',
157
+ transport: 'stdio',
158
+ requiredAuth: [],
159
+ serverName: 'docker',
160
+ jsonProjection: { command: 'npx', args: ['-y', '@hypnosis/docker-mcp-server'] },
161
+ excludeTools: ['remove_container', 'remove_image'],
162
+ backgroundAgentCompatible: false, // Requires local Docker
163
+ },
164
+ {
165
+ key: 'notion-mcp',
166
+ label: 'Notion',
167
+ description: 'Access Notion documentation and wikis.',
168
+ useWhen: 'Teams using Notion for docs or knowledge bases.',
169
+ adoption: 'Requires NOTION_API_KEY.',
170
+ trustLevel: 'medium',
171
+ transport: 'stdio',
172
+ requiredAuth: ['NOTION_API_KEY'],
173
+ serverName: 'notion',
174
+ jsonProjection: { command: 'npx', args: ['-y', '@notionhq/notion-mcp-server'], env: { NOTION_API_KEY: '${env:NOTION_API_KEY}' } },
175
+ excludeTools: [],
176
+ backgroundAgentCompatible: true,
177
+ },
178
+ {
179
+ key: 'linear-mcp',
180
+ label: 'Linear',
181
+ description: 'Issue tracking and sprint context.',
182
+ useWhen: 'Teams using Linear for issue tracking.',
183
+ adoption: 'Requires LINEAR_API_KEY.',
184
+ trustLevel: 'medium',
185
+ transport: 'stdio',
186
+ requiredAuth: ['LINEAR_API_KEY'],
187
+ serverName: 'linear',
188
+ jsonProjection: { command: 'npx', args: ['-y', '@mseep/linear-mcp'], env: { LINEAR_API_KEY: '${env:LINEAR_API_KEY}' } },
189
+ excludeTools: [],
190
+ backgroundAgentCompatible: true,
191
+ },
192
+ {
193
+ key: 'sentry-mcp',
194
+ label: 'Sentry',
195
+ description: 'Error tracking and debugging context.',
196
+ useWhen: 'Repos with Sentry error tracking.',
197
+ adoption: 'Requires SENTRY_AUTH_TOKEN.',
198
+ trustLevel: 'medium',
199
+ transport: 'stdio',
200
+ requiredAuth: ['SENTRY_AUTH_TOKEN'],
201
+ serverName: 'sentry',
202
+ jsonProjection: { command: 'npx', args: ['-y', '@sentry/mcp-server'], env: { SENTRY_AUTH_TOKEN: '${env:SENTRY_AUTH_TOKEN}' } },
203
+ excludeTools: [],
204
+ backgroundAgentCompatible: true,
205
+ },
206
+ {
207
+ key: 'slack-mcp',
208
+ label: 'Slack',
209
+ description: 'Draft and preview Slack messages.',
210
+ useWhen: 'Teams using Slack for communication.',
211
+ adoption: 'Requires SLACK_BOT_TOKEN.',
212
+ trustLevel: 'low',
213
+ transport: 'stdio',
214
+ requiredAuth: ['SLACK_BOT_TOKEN'],
215
+ serverName: 'slack',
216
+ jsonProjection: { command: 'npx', args: ['-y', 'slack-mcp-server'], env: { SLACK_BOT_TOKEN: '${env:SLACK_BOT_TOKEN}' } },
217
+ excludeTools: ['delete_message'],
218
+ backgroundAgentCompatible: true,
219
+ },
220
+ {
221
+ key: 'stripe-mcp',
222
+ label: 'Stripe',
223
+ description: 'Payment and billing workflow context.',
224
+ useWhen: 'Repos with Stripe integration.',
225
+ adoption: 'Requires STRIPE_API_KEY.',
226
+ trustLevel: 'low',
227
+ transport: 'stdio',
228
+ requiredAuth: ['STRIPE_API_KEY'],
229
+ serverName: 'stripe',
230
+ jsonProjection: { command: 'npx', args: ['-y', '@stripe/mcp'], env: { STRIPE_API_KEY: '${env:STRIPE_API_KEY}' } },
231
+ excludeTools: ['create_charge', 'delete_customer'],
232
+ backgroundAgentCompatible: true,
233
+ },
234
+ {
235
+ key: 'figma-mcp',
236
+ label: 'Figma',
237
+ description: 'Design file access and component inspection.',
238
+ useWhen: 'Design-heavy repos needing Figma access.',
239
+ adoption: 'Requires FIGMA_ACCESS_TOKEN.',
240
+ trustLevel: 'medium',
241
+ transport: 'stdio',
242
+ requiredAuth: ['FIGMA_ACCESS_TOKEN'],
243
+ serverName: 'figma',
244
+ jsonProjection: { command: 'npx', args: ['-y', 'claude-talk-to-figma-mcp'], env: { FIGMA_ACCESS_TOKEN: '${env:FIGMA_ACCESS_TOKEN}' } },
245
+ excludeTools: [],
246
+ backgroundAgentCompatible: false, // Requires OAuth
247
+ },
248
+ {
249
+ key: 'mcp-security',
250
+ label: 'MCP Security Scanner',
251
+ description: 'Scan MCP servers for tool poisoning and prompt injection.',
252
+ useWhen: 'Any repo with 2+ MCP servers.',
253
+ adoption: 'Safety companion for multi-MCP setups. Critical given Cursor CVE history.',
254
+ trustLevel: 'high',
255
+ transport: 'stdio',
256
+ requiredAuth: [],
257
+ serverName: 'mcp-scan',
258
+ jsonProjection: { command: 'npx', args: ['-y', 'mcp-scan@latest'] },
259
+ excludeTools: [],
260
+ backgroundAgentCompatible: true,
261
+ },
262
+ {
263
+ key: 'composio-mcp',
264
+ label: 'Composio Universal',
265
+ description: '500+ integrations through a single MCP gateway.',
266
+ useWhen: 'Enterprise or integration-heavy repos.',
267
+ adoption: 'Requires COMPOSIO_API_KEY.',
268
+ trustLevel: 'medium',
269
+ transport: 'stdio',
270
+ requiredAuth: ['COMPOSIO_API_KEY'],
271
+ serverName: 'composio',
272
+ jsonProjection: { command: 'npx', args: ['-y', '@composio/mcp'], env: { COMPOSIO_API_KEY: '${env:COMPOSIO_API_KEY}' } },
273
+ excludeTools: [],
274
+ backgroundAgentCompatible: true,
275
+ },
276
+ {
277
+ key: 'jira-confluence',
278
+ label: 'Jira',
279
+ description: 'Issue tracking and project management.',
280
+ useWhen: 'Teams using Atlassian Jira.',
281
+ adoption: 'Requires ATLASSIAN_API_TOKEN and ATLASSIAN_EMAIL.',
282
+ trustLevel: 'medium',
283
+ transport: 'stdio',
284
+ requiredAuth: ['ATLASSIAN_API_TOKEN', 'ATLASSIAN_EMAIL'],
285
+ serverName: 'jira',
286
+ jsonProjection: { command: 'npx', args: ['-y', 'jira-mcp'], env: { ATLASSIAN_API_TOKEN: '${env:ATLASSIAN_API_TOKEN}', ATLASSIAN_EMAIL: '${env:ATLASSIAN_EMAIL}' } },
287
+ excludeTools: [],
288
+ backgroundAgentCompatible: true,
289
+ },
290
+ {
291
+ key: 'ga4-analytics',
292
+ label: 'Google Analytics 4',
293
+ description: 'Live GA4 data, attribution, and audience insights.',
294
+ useWhen: 'Repos with web analytics needs.',
295
+ adoption: 'Requires GA4_PROPERTY_ID and GOOGLE_APPLICATION_CREDENTIALS.',
296
+ trustLevel: 'medium',
297
+ transport: 'stdio',
298
+ requiredAuth: ['GA4_PROPERTY_ID', 'GOOGLE_APPLICATION_CREDENTIALS'],
299
+ serverName: 'ga4',
300
+ jsonProjection: { command: 'npx', args: ['-y', 'mcp-server-ga4'], env: { GA4_PROPERTY_ID: '${env:GA4_PROPERTY_ID}', GOOGLE_APPLICATION_CREDENTIALS: '${env:GOOGLE_APPLICATION_CREDENTIALS}' } },
301
+ excludeTools: [],
302
+ backgroundAgentCompatible: false, // Requires OAuth
303
+ },
304
+ {
305
+ key: 'search-console',
306
+ label: 'Google Search Console',
307
+ description: 'Search performance and indexing data.',
308
+ useWhen: 'SEO-focused repos.',
309
+ adoption: 'Requires Google OAuth credentials.',
310
+ trustLevel: 'medium',
311
+ transport: 'stdio',
312
+ requiredAuth: ['GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET'],
313
+ serverName: 'gsc',
314
+ jsonProjection: { command: 'npx', args: ['-y', 'mcp-gsc@latest'], env: { GOOGLE_CLIENT_ID: '${env:GOOGLE_CLIENT_ID}', GOOGLE_CLIENT_SECRET: '${env:GOOGLE_CLIENT_SECRET}' } },
315
+ excludeTools: [],
316
+ backgroundAgentCompatible: false, // Requires OAuth
317
+ },
318
+ {
319
+ key: 'n8n-workflows',
320
+ label: 'n8n Workflow Automation',
321
+ description: 'Workflow automation with 1,396 integration nodes.',
322
+ useWhen: 'Teams using n8n for workflow automation.',
323
+ adoption: 'Requires N8N_URL and N8N_API_KEY.',
324
+ trustLevel: 'medium',
325
+ transport: 'stdio',
326
+ requiredAuth: ['N8N_URL', 'N8N_API_KEY'],
327
+ serverName: 'n8n',
328
+ jsonProjection: { command: 'npx', args: ['-y', 'n8n-mcp-server@latest'], env: { N8N_URL: '${env:N8N_URL}', N8N_API_KEY: '${env:N8N_API_KEY}' } },
329
+ excludeTools: [],
330
+ backgroundAgentCompatible: true,
331
+ },
332
+ {
333
+ key: 'zendesk-mcp',
334
+ label: 'Zendesk',
335
+ description: 'Ticket management and help center content.',
336
+ useWhen: 'Support teams using Zendesk.',
337
+ adoption: 'Requires ZENDESK_API_TOKEN and ZENDESK_SUBDOMAIN.',
338
+ trustLevel: 'medium',
339
+ transport: 'stdio',
340
+ requiredAuth: ['ZENDESK_API_TOKEN', 'ZENDESK_SUBDOMAIN'],
341
+ serverName: 'zendesk',
342
+ jsonProjection: { command: 'npx', args: ['-y', 'zendesk-mcp'], env: { ZENDESK_API_TOKEN: '${env:ZENDESK_API_TOKEN}', ZENDESK_SUBDOMAIN: '${env:ZENDESK_SUBDOMAIN}' } },
343
+ excludeTools: [],
344
+ backgroundAgentCompatible: true,
345
+ },
346
+ {
347
+ key: 'infisical-secrets',
348
+ label: 'Infisical Secrets',
349
+ description: 'Secrets management with auto-rotation.',
350
+ useWhen: 'Repos using Infisical for secrets.',
351
+ adoption: 'Requires INFISICAL_TOKEN.',
352
+ trustLevel: 'low',
353
+ transport: 'stdio',
354
+ requiredAuth: ['INFISICAL_TOKEN'],
355
+ serverName: 'infisical',
356
+ jsonProjection: { command: 'npx', args: ['-y', '@infisical/mcp'], env: { INFISICAL_TOKEN: '${env:INFISICAL_TOKEN}' } },
357
+ excludeTools: ['delete_secret', 'update_secret'],
358
+ backgroundAgentCompatible: true,
359
+ },
360
+ {
361
+ key: 'shopify-mcp',
362
+ label: 'Shopify',
363
+ description: 'Shopify API and deployment tooling.',
364
+ useWhen: 'Shopify stores and apps.',
365
+ adoption: 'Requires SHOPIFY_ACCESS_TOKEN.',
366
+ trustLevel: 'medium',
367
+ transport: 'stdio',
368
+ requiredAuth: ['SHOPIFY_ACCESS_TOKEN'],
369
+ serverName: 'shopify',
370
+ jsonProjection: { command: 'npx', args: ['-y', 'shopify-mcp'], env: { SHOPIFY_ACCESS_TOKEN: '${env:SHOPIFY_ACCESS_TOKEN}' } },
371
+ excludeTools: [],
372
+ backgroundAgentCompatible: true,
373
+ },
374
+ {
375
+ key: 'huggingface-mcp',
376
+ label: 'Hugging Face',
377
+ description: 'Model search, dataset discovery, and Spaces.',
378
+ useWhen: 'AI/ML repos needing model registry access.',
379
+ adoption: 'Requires HF_TOKEN.',
380
+ trustLevel: 'medium',
381
+ transport: 'stdio',
382
+ requiredAuth: ['HF_TOKEN'],
383
+ serverName: 'huggingface',
384
+ jsonProjection: { command: 'npx', args: ['-y', 'huggingface-mcp-server'], env: { HF_TOKEN: '${env:HF_TOKEN}' } },
385
+ excludeTools: [],
386
+ backgroundAgentCompatible: true,
387
+ },
388
+ // ── 23 new packs ─────────────────────────────────────────────────────────
389
+ {
390
+ key: 'supabase-mcp', label: 'Supabase',
391
+ description: 'Database, auth, and storage access for Supabase projects.',
392
+ useWhen: 'Repos using Supabase for database, auth, or storage.',
393
+ adoption: 'Recommended for full-stack Supabase repos. Requires SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY.',
394
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY'],
395
+ serverName: 'supabase',
396
+ jsonProjection: { command: 'npx', args: ['-y', '@supabase/mcp-server-supabase@latest'], env: { SUPABASE_URL: '${env:SUPABASE_URL}', SUPABASE_SERVICE_ROLE_KEY: '${env:SUPABASE_SERVICE_ROLE_KEY}' } },
397
+ excludeTools: ['delete_project', 'drop_table'], backgroundAgentCompatible: true,
398
+ },
399
+ {
400
+ key: 'prisma-mcp', label: 'Prisma ORM',
401
+ description: 'Schema inspection and migration management for Prisma.',
402
+ useWhen: 'Repos using Prisma for database schema and migrations.',
403
+ adoption: 'Recommended for any repo with a Prisma schema. Requires DATABASE_URL.',
404
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['DATABASE_URL'],
405
+ serverName: 'prisma',
406
+ jsonProjection: { command: 'npx', args: ['-y', 'prisma-mcp-server@latest'], env: { DATABASE_URL: '${env:DATABASE_URL}' } },
407
+ excludeTools: ['drop_database'], backgroundAgentCompatible: false,
408
+ },
409
+ {
410
+ key: 'vercel-mcp', label: 'Vercel',
411
+ description: 'Deployment management and log access for Vercel projects.',
412
+ useWhen: 'Repos deployed on Vercel.',
413
+ adoption: 'Recommended for Vercel-hosted repos. Requires VERCEL_TOKEN.',
414
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['VERCEL_TOKEN'],
415
+ serverName: 'vercel',
416
+ jsonProjection: { command: 'npx', args: ['-y', '@vercel/mcp-server@latest'], env: { VERCEL_TOKEN: '${env:VERCEL_TOKEN}' } },
417
+ excludeTools: ['delete_project', 'delete_deployment'], backgroundAgentCompatible: true,
418
+ },
419
+ {
420
+ key: 'cloudflare-mcp', label: 'Cloudflare',
421
+ description: 'Workers, KV, R2, and D1 management.',
422
+ useWhen: 'Repos using Cloudflare Workers, KV, R2, or D1.',
423
+ adoption: 'Recommended for edge-compute repos. Requires CLOUDFLARE_API_TOKEN.',
424
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CLOUDFLARE_API_TOKEN'],
425
+ serverName: 'cloudflare',
426
+ jsonProjection: { command: 'npx', args: ['-y', '@cloudflare/mcp-server-cloudflare@latest'], env: { CLOUDFLARE_API_TOKEN: '${env:CLOUDFLARE_API_TOKEN}' } },
427
+ excludeTools: ['delete_worker', 'purge_cache'], backgroundAgentCompatible: true,
428
+ },
429
+ {
430
+ key: 'aws-mcp', label: 'AWS',
431
+ description: 'S3, Lambda, DynamoDB, and CloudFormation access.',
432
+ useWhen: 'Repos using AWS cloud services.',
433
+ adoption: 'Recommended for cloud-infra repos. Requires AWS credentials.',
434
+ trustLevel: 'low', transport: 'stdio', requiredAuth: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_REGION'],
435
+ serverName: 'aws',
436
+ jsonProjection: { command: 'npx', args: ['-y', '@aws-samples/mcp-server-aws@latest'], env: { AWS_ACCESS_KEY_ID: '${env:AWS_ACCESS_KEY_ID}', AWS_SECRET_ACCESS_KEY: '${env:AWS_SECRET_ACCESS_KEY}', AWS_REGION: '${env:AWS_REGION}' } },
437
+ excludeTools: ['delete_stack', 'terminate_instances', 'delete_bucket'], backgroundAgentCompatible: true,
438
+ },
439
+ {
440
+ key: 'redis-mcp', label: 'Redis',
441
+ description: 'Cache and session management via Redis.',
442
+ useWhen: 'Repos using Redis for caching or sessions.',
443
+ adoption: 'Recommended for performance-critical repos. Requires REDIS_URL.',
444
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['REDIS_URL'],
445
+ serverName: 'redis',
446
+ jsonProjection: { command: 'npx', args: ['-y', 'redis-mcp-server@latest'], env: { REDIS_URL: '${env:REDIS_URL}' } },
447
+ excludeTools: ['flushall', 'flushdb'], backgroundAgentCompatible: true,
448
+ },
449
+ {
450
+ key: 'mongodb-mcp', label: 'MongoDB',
451
+ description: 'Document database access for MongoDB.',
452
+ useWhen: 'Repos using MongoDB.',
453
+ adoption: 'Recommended for document-model repos. Requires MONGODB_URI.',
454
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['MONGODB_URI'],
455
+ serverName: 'mongodb',
456
+ jsonProjection: { command: 'npx', args: ['-y', '@mongodb-js/mongodb-mcp-server@latest'], env: { MONGODB_URI: '${env:MONGODB_URI}' } },
457
+ excludeTools: ['drop_collection', 'drop_database'], backgroundAgentCompatible: false,
458
+ },
459
+ {
460
+ key: 'twilio-mcp', label: 'Twilio',
461
+ description: 'SMS, voice, and messaging via Twilio.',
462
+ useWhen: 'Repos using Twilio for communications.',
463
+ adoption: 'Recommended for communication-feature repos. Requires TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN.',
464
+ trustLevel: 'low', transport: 'stdio', requiredAuth: ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN'],
465
+ serverName: 'twilio',
466
+ jsonProjection: { command: 'npx', args: ['-y', 'twilio-mcp-server@latest'], env: { TWILIO_ACCOUNT_SID: '${env:TWILIO_ACCOUNT_SID}', TWILIO_AUTH_TOKEN: '${env:TWILIO_AUTH_TOKEN}' } },
467
+ excludeTools: ['delete_message'], backgroundAgentCompatible: true,
468
+ },
469
+ {
470
+ key: 'sendgrid-mcp', label: 'SendGrid',
471
+ description: 'Transactional and marketing email via SendGrid.',
472
+ useWhen: 'Repos using SendGrid for email delivery.',
473
+ adoption: 'Recommended for repos with email workflows. Requires SENDGRID_API_KEY.',
474
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['SENDGRID_API_KEY'],
475
+ serverName: 'sendgrid',
476
+ jsonProjection: { command: 'npx', args: ['-y', 'sendgrid-mcp-server@latest'], env: { SENDGRID_API_KEY: '${env:SENDGRID_API_KEY}' } },
477
+ excludeTools: [], backgroundAgentCompatible: true,
478
+ },
479
+ {
480
+ key: 'algolia-mcp', label: 'Algolia Search',
481
+ description: 'Search indexing and query management via Algolia.',
482
+ useWhen: 'Repos using Algolia for search.',
483
+ adoption: 'Recommended for content-heavy and e-commerce repos. Requires ALGOLIA_APP_ID and ALGOLIA_API_KEY.',
484
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['ALGOLIA_APP_ID', 'ALGOLIA_API_KEY'],
485
+ serverName: 'algolia',
486
+ jsonProjection: { command: 'npx', args: ['-y', 'algolia-mcp-server@latest'], env: { ALGOLIA_APP_ID: '${env:ALGOLIA_APP_ID}', ALGOLIA_API_KEY: '${env:ALGOLIA_API_KEY}' } },
487
+ excludeTools: ['delete_index'], backgroundAgentCompatible: true,
488
+ },
489
+ {
490
+ key: 'planetscale-mcp', label: 'PlanetScale',
491
+ description: 'MySQL database management via PlanetScale.',
492
+ useWhen: 'Repos using PlanetScale for serverless MySQL.',
493
+ adoption: 'Recommended for MySQL-based repos on PlanetScale. Requires PLANETSCALE_TOKEN.',
494
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['PLANETSCALE_TOKEN'],
495
+ serverName: 'planetscale',
496
+ jsonProjection: { command: 'npx', args: ['-y', 'planetscale-mcp-server@latest'], env: { PLANETSCALE_TOKEN: '${env:PLANETSCALE_TOKEN}' } },
497
+ excludeTools: ['delete_database'], backgroundAgentCompatible: true,
498
+ },
499
+ {
500
+ key: 'neon-mcp', label: 'Neon Serverless Postgres',
501
+ description: 'Serverless PostgreSQL management via Neon.',
502
+ useWhen: 'Repos using Neon for serverless Postgres.',
503
+ adoption: 'Recommended for serverless and edge Postgres repos. Requires NEON_API_KEY.',
504
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['NEON_API_KEY'],
505
+ serverName: 'neon',
506
+ jsonProjection: { command: 'npx', args: ['-y', '@neondatabase/mcp-server-neon@latest'], env: { NEON_API_KEY: '${env:NEON_API_KEY}' } },
507
+ excludeTools: ['delete_project'], backgroundAgentCompatible: true,
508
+ },
509
+ {
510
+ key: 'turso-mcp', label: 'Turso Edge SQLite',
511
+ description: 'Distributed edge SQLite management via Turso.',
512
+ useWhen: 'Repos using Turso for edge SQLite.',
513
+ adoption: 'Recommended for edge and multi-region apps. Requires TURSO_DATABASE_URL and TURSO_AUTH_TOKEN.',
514
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['TURSO_DATABASE_URL', 'TURSO_AUTH_TOKEN'],
515
+ serverName: 'turso',
516
+ jsonProjection: { command: 'npx', args: ['-y', 'turso-mcp-server@latest'], env: { TURSO_DATABASE_URL: '${env:TURSO_DATABASE_URL}', TURSO_AUTH_TOKEN: '${env:TURSO_AUTH_TOKEN}' } },
517
+ excludeTools: ['destroy_database'], backgroundAgentCompatible: true,
518
+ },
519
+ {
520
+ key: 'upstash-mcp', label: 'Upstash (Redis + Kafka)',
521
+ description: 'Serverless Redis, Kafka, and QStash via Upstash.',
522
+ useWhen: 'Repos using Upstash for serverless caching or messaging.',
523
+ adoption: 'Recommended for serverless apps. Requires UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN.',
524
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['UPSTASH_REDIS_REST_URL', 'UPSTASH_REDIS_REST_TOKEN'],
525
+ serverName: 'upstash',
526
+ jsonProjection: { command: 'npx', args: ['-y', '@upstash/mcp-server@latest'], env: { UPSTASH_REDIS_REST_URL: '${env:UPSTASH_REDIS_REST_URL}', UPSTASH_REDIS_REST_TOKEN: '${env:UPSTASH_REDIS_REST_TOKEN}' } },
527
+ excludeTools: [], backgroundAgentCompatible: true,
528
+ },
529
+ {
530
+ key: 'convex-mcp', label: 'Convex',
531
+ description: 'Reactive backend-as-a-service management via Convex.',
532
+ useWhen: 'Repos using Convex as reactive backend.',
533
+ adoption: 'Recommended for real-time full-stack repos. Requires CONVEX_DEPLOYMENT.',
534
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CONVEX_DEPLOYMENT'],
535
+ serverName: 'convex',
536
+ jsonProjection: { command: 'npx', args: ['-y', '@convex-dev/mcp-server@latest'], env: { CONVEX_DEPLOYMENT: '${env:CONVEX_DEPLOYMENT}' } },
537
+ excludeTools: ['delete_deployment'], backgroundAgentCompatible: true,
538
+ },
539
+ {
540
+ key: 'clerk-mcp', label: 'Clerk Authentication',
541
+ description: 'User auth and session management via Clerk.',
542
+ useWhen: 'Repos using Clerk for authentication.',
543
+ adoption: 'Recommended for SaaS repos with Clerk. Requires CLERK_SECRET_KEY.',
544
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CLERK_SECRET_KEY'],
545
+ serverName: 'clerk',
546
+ jsonProjection: { command: 'npx', args: ['-y', '@clerk/mcp-server@latest'], env: { CLERK_SECRET_KEY: '${env:CLERK_SECRET_KEY}' } },
547
+ excludeTools: ['delete_user'], backgroundAgentCompatible: true,
548
+ },
549
+ {
550
+ key: 'resend-mcp', label: 'Resend Email',
551
+ description: 'Developer-focused transactional email via Resend.',
552
+ useWhen: 'Repos using Resend for email.',
553
+ adoption: 'Recommended for modern full-stack repos. Requires RESEND_API_KEY.',
554
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['RESEND_API_KEY'],
555
+ serverName: 'resend',
556
+ jsonProjection: { command: 'npx', args: ['-y', 'resend-mcp-server@latest'], env: { RESEND_API_KEY: '${env:RESEND_API_KEY}' } },
557
+ excludeTools: [], backgroundAgentCompatible: true,
558
+ },
559
+ {
560
+ key: 'temporal-mcp', label: 'Temporal Workflow',
561
+ description: 'Durable workflow orchestration via Temporal.',
562
+ useWhen: 'Repos using Temporal for workflows.',
563
+ adoption: 'Recommended for async-workflow and microservice repos. Requires TEMPORAL_ADDRESS.',
564
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['TEMPORAL_ADDRESS'],
565
+ serverName: 'temporal',
566
+ jsonProjection: { command: 'npx', args: ['-y', 'temporal-mcp-server@latest'], env: { TEMPORAL_ADDRESS: '${env:TEMPORAL_ADDRESS}' } },
567
+ excludeTools: ['terminate_workflow'], backgroundAgentCompatible: true,
568
+ },
569
+ {
570
+ key: 'launchdarkly-mcp', label: 'LaunchDarkly',
571
+ description: 'Feature flags and experimentation via LaunchDarkly.',
572
+ useWhen: 'Repos using LaunchDarkly for feature flags.',
573
+ adoption: 'Recommended for feature-flag-driven development. Requires LAUNCHDARKLY_ACCESS_TOKEN.',
574
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['LAUNCHDARKLY_ACCESS_TOKEN'],
575
+ serverName: 'launchdarkly',
576
+ jsonProjection: { command: 'npx', args: ['-y', 'launchdarkly-mcp-server@latest'], env: { LAUNCHDARKLY_ACCESS_TOKEN: '${env:LAUNCHDARKLY_ACCESS_TOKEN}' } },
577
+ excludeTools: ['delete_flag'], backgroundAgentCompatible: true,
578
+ },
579
+ {
580
+ key: 'datadog-mcp', label: 'Datadog',
581
+ description: 'Monitoring, APM, and log management via Datadog.',
582
+ useWhen: 'Repos using Datadog for observability.',
583
+ adoption: 'Recommended for production repos. Requires DATADOG_API_KEY and DATADOG_APP_KEY.',
584
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['DATADOG_API_KEY', 'DATADOG_APP_KEY'],
585
+ serverName: 'datadog',
586
+ jsonProjection: { command: 'npx', args: ['-y', '@datadog/mcp-server@latest'], env: { DATADOG_API_KEY: '${env:DATADOG_API_KEY}', DATADOG_APP_KEY: '${env:DATADOG_APP_KEY}' } },
587
+ excludeTools: ['delete_monitor'], backgroundAgentCompatible: true,
588
+ },
589
+ {
590
+ key: 'grafana-mcp', label: 'Grafana',
591
+ description: 'Dashboard and observability access via Grafana.',
592
+ useWhen: 'Repos using Grafana for dashboards.',
593
+ adoption: 'Recommended for observability-focused repos. Requires GRAFANA_URL and GRAFANA_API_KEY.',
594
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['GRAFANA_URL', 'GRAFANA_API_KEY'],
595
+ serverName: 'grafana',
596
+ jsonProjection: { command: 'npx', args: ['-y', 'grafana-mcp-server@latest'], env: { GRAFANA_URL: '${env:GRAFANA_URL}', GRAFANA_API_KEY: '${env:GRAFANA_API_KEY}' } },
597
+ excludeTools: ['delete_dashboard'], backgroundAgentCompatible: true,
598
+ },
599
+ {
600
+ key: 'circleci-mcp', label: 'CircleCI',
601
+ description: 'CI/CD pipeline access via CircleCI.',
602
+ useWhen: 'Repos using CircleCI for CI/CD.',
603
+ adoption: 'Recommended for CircleCI-powered projects. Requires CIRCLECI_TOKEN.',
604
+ trustLevel: 'medium', transport: 'stdio', requiredAuth: ['CIRCLECI_TOKEN'],
605
+ serverName: 'circleci',
606
+ jsonProjection: { command: 'npx', args: ['-y', 'circleci-mcp-server@latest'], env: { CIRCLECI_TOKEN: '${env:CIRCLECI_TOKEN}' } },
607
+ excludeTools: ['cancel_pipeline'], backgroundAgentCompatible: true,
608
+ },
609
+ {
610
+ key: 'anthropic-mcp', label: 'Anthropic Claude API',
611
+ description: 'Claude API access for AI-powered apps.',
612
+ useWhen: 'Repos building on the Anthropic Claude API.',
613
+ adoption: 'Recommended for AI-powered apps using Claude. Requires ANTHROPIC_API_KEY.',
614
+ trustLevel: 'high', transport: 'stdio', requiredAuth: ['ANTHROPIC_API_KEY'],
615
+ serverName: 'anthropic',
616
+ jsonProjection: { command: 'npx', args: ['-y', '@anthropic-ai/mcp-server@latest'], env: { ANTHROPIC_API_KEY: '${env:ANTHROPIC_API_KEY}' } },
617
+ excludeTools: [], backgroundAgentCompatible: true,
618
+ },
619
+ ];
620
+
621
+ // --- Helpers ---
622
+
623
+ function clone(value) {
624
+ return JSON.parse(JSON.stringify(value));
625
+ }
626
+
627
+ function hasDependency(deps, name) {
628
+ return Object.prototype.hasOwnProperty.call(deps || {}, name);
629
+ }
630
+
631
+ function hasFileContentMatch(ctx, filePath, pattern) {
632
+ if (!ctx) return false;
633
+ const content = ctx.fileContent(filePath);
634
+ return !!(content && pattern.test(content));
635
+ }
636
+
637
+ function getProjectDependencies(ctx) {
638
+ if (!ctx) return {};
639
+ if (typeof ctx.projectDependencies === 'function') return ctx.projectDependencies();
640
+ const pkg = ctx.jsonFile('package.json') || {};
641
+ return { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
642
+ }
643
+
644
+ function hasPostgresSignals(ctx, deps) {
645
+ if (hasDependency(deps, 'pg') || hasDependency(deps, 'postgres') || hasDependency(deps, 'pg-promise') ||
646
+ hasDependency(deps, 'slonik') || hasDependency(deps, '@neondatabase/serverless') || hasDependency(deps, '@vercel/postgres')) {
647
+ return true;
648
+ }
649
+ return (
650
+ hasFileContentMatch(ctx, 'prisma/schema.prisma', /provider\s*=\s*["']postgresql["']/i) ||
651
+ hasFileContentMatch(ctx, 'docker-compose.yml', /\bpostgres\b/i) ||
652
+ hasFileContentMatch(ctx, 'docker-compose.yaml', /\bpostgres\b/i)
653
+ );
654
+ }
655
+
656
+ // --- Core Functions ---
657
+
658
+ function getCursorMcpPack(key) {
659
+ return CURSOR_MCP_PACKS.find(pack => pack.key === key) || null;
660
+ }
661
+
662
+ function normalizeCursorMcpPackKeys(keys = []) {
663
+ return [...new Set((Array.isArray(keys) ? keys : [])
664
+ .map(key => `${key}`.trim())
665
+ .filter(Boolean))]
666
+ .filter(key => !!getCursorMcpPack(key));
667
+ }
668
+
669
+ /**
670
+ * Generate .cursor/mcp.json entry for a single MCP pack.
671
+ * Cursor uses .cursor/mcp.json with "mcpServers" wrapper.
672
+ */
673
+ function packToJson(pack) {
674
+ const entry = {};
675
+ const proj = pack.jsonProjection;
676
+
677
+ if (proj.command) entry.command = proj.command;
678
+ if (proj.url) entry.url = proj.url;
679
+ if (proj.args && proj.args.length > 0) entry.args = [...proj.args];
680
+ if (proj.env && Object.keys(proj.env).length > 0) entry.env = { ...proj.env };
681
+
682
+ return { [pack.serverName]: entry };
683
+ }
684
+
685
+ /**
686
+ * Detect which MCP packs to recommend for a Cursor project.
687
+ */
688
+ function recommendCursorMcpPacks(stacks = [], domainPacks = [], options = {}) {
689
+ const recommended = new Set();
690
+ const stackKeys = new Set(stacks.map(s => s.key));
691
+ const ctx = options.ctx || null;
692
+ const deps = getProjectDependencies(ctx);
693
+ const domainKeys = new Set(domainPacks.map(p => p.key));
694
+ const backgroundOnly = options.backgroundOnly === true;
695
+
696
+ if (stackKeys.size > 0) recommended.add('context7-docs');
697
+ if (domainKeys.has('enterprise-governed') || domainKeys.has('monorepo')) recommended.add('github-mcp');
698
+
699
+ if (domainKeys.has('frontend-ui') || stackKeys.has('react') || stackKeys.has('nextjs') ||
700
+ stackKeys.has('vue') || stackKeys.has('angular') || stackKeys.has('svelte')) {
701
+ recommended.add('playwright-mcp');
702
+ }
703
+
704
+ if (stackKeys.has('nextjs') || hasDependency(deps, 'next')) recommended.add('next-devtools');
705
+
706
+ if ((domainKeys.has('backend-api') || domainKeys.has('infra-platform')) && hasPostgresSignals(ctx, deps)) {
707
+ recommended.add('postgres-mcp');
708
+ }
709
+
710
+ if (domainKeys.has('monorepo') || domainKeys.has('enterprise-governed')) recommended.add('memory-mcp');
711
+ if (domainKeys.has('enterprise-governed') || domainKeys.has('monorepo') || domainKeys.has('infra-platform')) recommended.add('sequential-thinking');
712
+ if (domainKeys.has('infra-platform')) recommended.add('filesystem-mcp');
713
+
714
+ if (domainKeys.has('backend-api') && ctx && (hasDependency(deps, 'axios') || hasDependency(deps, 'node-fetch') || hasDependency(deps, 'got'))) {
715
+ recommended.add('fetch-mcp');
716
+ }
717
+
718
+ if (domainKeys.has('infra-platform') || domainKeys.has('devops-cicd')) recommended.add('docker-mcp');
719
+ if (domainKeys.has('ecommerce') && (hasDependency(deps, 'stripe') || hasDependency(deps, '@stripe/stripe-js'))) recommended.add('stripe-mcp');
720
+ if (domainKeys.has('ecommerce') && (hasDependency(deps, 'shopify') || hasDependency(deps, '@shopify/shopify-api'))) recommended.add('shopify-mcp');
721
+ if (domainKeys.has('ai-ml')) recommended.add('huggingface-mcp');
722
+ if (domainKeys.has('design-system')) recommended.add('figma-mcp');
723
+ // ── 23 new packs recommendation logic ────────────────────────────────────
724
+ if (ctx) {
725
+ if (hasDependency(deps, '@supabase/supabase-js') || hasDependency(deps, '@supabase/auth-helpers-nextjs') || hasFileContentMatch(ctx, '.env', /SUPABASE/i) || hasFileContentMatch(ctx, '.env.example', /SUPABASE/i)) recommended.add('supabase-mcp');
726
+ if (hasFileContentMatch(ctx, 'schema.prisma', /\S/) || hasDependency(deps, '@prisma/client') || hasDependency(deps, 'prisma')) recommended.add('prisma-mcp');
727
+ if (ctx.files.includes('vercel.json') || hasFileContentMatch(ctx, 'package.json', /"deploy":\s*"vercel/i) || hasFileContentMatch(ctx, '.env', /VERCEL_TOKEN/i)) recommended.add('vercel-mcp');
728
+ if (hasFileContentMatch(ctx, 'wrangler.toml', /\S/) || hasDependency(deps, 'wrangler') || hasFileContentMatch(ctx, '.env', /CLOUDFLARE/i)) recommended.add('cloudflare-mcp');
729
+ if (hasFileContentMatch(ctx, '.env', /AWS_ACCESS_KEY/i) || ctx.files.some(f => /serverless\.yml|template\.ya?ml|cdk\.json/.test(f))) recommended.add('aws-mcp');
730
+ if (hasDependency(deps, 'redis') || hasDependency(deps, 'ioredis') || hasDependency(deps, '@redis/client') || hasFileContentMatch(ctx, '.env', /REDIS_URL/i)) recommended.add('redis-mcp');
731
+ if (hasDependency(deps, 'mongoose') || hasDependency(deps, 'mongodb') || hasFileContentMatch(ctx, '.env', /MONGODB_URI/i)) recommended.add('mongodb-mcp');
732
+ if (hasDependency(deps, 'twilio') || hasFileContentMatch(ctx, '.env', /TWILIO_/i)) recommended.add('twilio-mcp');
733
+ if (hasDependency(deps, '@sendgrid/mail') || hasFileContentMatch(ctx, '.env', /SENDGRID_API_KEY/i)) recommended.add('sendgrid-mcp');
734
+ if (hasDependency(deps, 'algoliasearch') || hasDependency(deps, '@algolia/client-search') || hasFileContentMatch(ctx, '.env', /ALGOLIA_/i)) recommended.add('algolia-mcp');
735
+ if (hasFileContentMatch(ctx, '.env', /PLANETSCALE_TOKEN/i)) recommended.add('planetscale-mcp');
736
+ if (hasDependency(deps, '@neondatabase/serverless') || hasFileContentMatch(ctx, '.env', /NEON_/i)) recommended.add('neon-mcp');
737
+ if (hasDependency(deps, '@libsql/client') || hasFileContentMatch(ctx, '.env', /TURSO_/i)) recommended.add('turso-mcp');
738
+ if (hasDependency(deps, '@upstash/redis') || hasDependency(deps, '@upstash/kafka') || hasFileContentMatch(ctx, '.env', /UPSTASH_/i)) recommended.add('upstash-mcp');
739
+ if (hasDependency(deps, 'convex') || hasFileContentMatch(ctx, 'convex.json', /\S/) || hasFileContentMatch(ctx, '.env', /CONVEX_/i)) recommended.add('convex-mcp');
740
+ if (hasDependency(deps, '@clerk/nextjs') || hasDependency(deps, '@clerk/backend') || hasFileContentMatch(ctx, '.env', /CLERK_/i)) recommended.add('clerk-mcp');
741
+ if (hasDependency(deps, 'resend') || hasFileContentMatch(ctx, '.env', /RESEND_API_KEY/i)) recommended.add('resend-mcp');
742
+ if (hasDependency(deps, '@temporalio/client') || hasFileContentMatch(ctx, '.env', /TEMPORAL_/i)) recommended.add('temporal-mcp');
743
+ if (hasDependency(deps, '@launchdarkly/node-server-sdk') || hasFileContentMatch(ctx, '.env', /LAUNCHDARKLY_/i)) recommended.add('launchdarkly-mcp');
744
+ if (hasDependency(deps, 'dd-trace') || hasFileContentMatch(ctx, '.env', /DATADOG_/i)) recommended.add('datadog-mcp');
745
+ if (hasFileContentMatch(ctx, 'docker-compose.yml', /grafana/i) || hasFileContentMatch(ctx, '.env', /GRAFANA_/i)) recommended.add('grafana-mcp');
746
+ if (ctx.files.some(f => /\.circleci\/config/.test(f)) || hasFileContentMatch(ctx, '.env', /CIRCLECI_/i)) recommended.add('circleci-mcp');
747
+ if (hasDependency(deps, '@anthropic-ai/sdk') || hasDependency(deps, 'anthropic') || hasFileContentMatch(ctx, '.env', /ANTHROPIC_API_KEY/i)) recommended.add('anthropic-mcp');
748
+ }
749
+ if (recommended.size >= 2) recommended.add('mcp-security');
750
+ if (recommended.size === 0) recommended.add('context7-docs');
751
+
752
+ let result = CURSOR_MCP_PACKS.filter(pack => recommended.has(pack.key)).map(pack => clone(pack));
753
+
754
+ // Filter out background-incompatible packs if targeting background agents
755
+ if (backgroundOnly) {
756
+ result = result.filter(pack => pack.backgroundAgentCompatible !== false);
757
+ }
758
+
759
+ return result;
760
+ }
761
+
762
+ /**
763
+ * Trust preflight: check if packs are safe to install.
764
+ */
765
+ function getCursorMcpPreflight(packKeys = [], env = process.env) {
766
+ return normalizeCursorMcpPackKeys(packKeys)
767
+ .map(key => {
768
+ const pack = getCursorMcpPack(key);
769
+ if (!pack) return null;
770
+ const missingEnvVars = pack.requiredAuth.filter(envKey => {
771
+ const value = env && Object.prototype.hasOwnProperty.call(env, envKey) ? env[envKey] : '';
772
+ return !`${value || ''}`.trim();
773
+ });
774
+ return {
775
+ key,
776
+ label: pack.label,
777
+ trustLevel: pack.trustLevel,
778
+ transport: pack.transport,
779
+ requiredAuth: pack.requiredAuth,
780
+ missingEnvVars,
781
+ safe: missingEnvVars.length === 0,
782
+ backgroundAgentCompatible: pack.backgroundAgentCompatible,
783
+ warning: missingEnvVars.length > 0
784
+ ? `Missing env vars: ${missingEnvVars.join(', ')}. Pack will be included but may fail at runtime.`
785
+ : null,
786
+ };
787
+ })
788
+ .filter(Boolean);
789
+ }
790
+
791
+ /**
792
+ * Merge MCP packs into existing .cursor/mcp.json content.
793
+ * Uses "mcpServers" wrapper format (Cursor-specific).
794
+ */
795
+ function mergeCursorMcpJson(existingContent = {}, packKeys = []) {
796
+ let settings;
797
+ if (typeof existingContent === 'string') {
798
+ try { settings = JSON.parse(existingContent); } catch { settings = {}; }
799
+ } else {
800
+ settings = clone(existingContent);
801
+ }
802
+
803
+ if (!settings.mcpServers || typeof settings.mcpServers !== 'object') {
804
+ settings.mcpServers = {};
805
+ }
806
+
807
+ const existingServers = new Set(Object.keys(settings.mcpServers));
808
+ const newPacks = normalizeCursorMcpPackKeys(packKeys)
809
+ .map(key => getCursorMcpPack(key))
810
+ .filter(pack => pack && !existingServers.has(pack.serverName));
811
+
812
+ for (const pack of newPacks) {
813
+ const entry = packToJson(pack);
814
+ const serverName = Object.keys(entry)[0];
815
+ settings.mcpServers[serverName] = entry[serverName];
816
+ }
817
+
818
+ return settings;
819
+ }
820
+
821
+ module.exports = {
822
+ CURSOR_MCP_PACKS,
823
+ getCursorMcpPack,
824
+ recommendCursorMcpPacks,
825
+ getCursorMcpPreflight,
826
+ mergeCursorMcpJson,
827
+ packToJson,
828
+ };