@salesforce/mcp 0.26.1 → 0.26.3
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.
- package/README.md +14 -20
- package/lib/registry.js +2 -0
- package/npm-shrinkwrap.json +497 -366
- package/package.json +5 -4
package/README.md
CHANGED
|
@@ -48,17 +48,19 @@ Here's an example for VS Code with Copilot in which you create and update a `.vs
|
|
|
48
48
|
}
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
The `args` format shown in the preceding example is the same for all MCP clients; it's how you customize the DX MCP Server for your particular environment.
|
|
51
|
+
The `args` format shown in the preceding example is the same for all MCP clients; it's how you customize the DX MCP Server for your particular environment.
|
|
52
52
|
|
|
53
|
+
**Notes**:
|
|
53
54
|
- The `"-y", "@salesforce/mcp"` part tells `npx` to automatically install the `@salesforce/mcp` package instead of asking permission. Don't change this.
|
|
54
|
-
-
|
|
55
|
+
- For possible flags that you can pass to the `args` option, and the possible values that you can pass to the `--orgs`, `--toolsets`, and `--tools` flags, see these sections:
|
|
56
|
+
- [Available Flags for the `args` Option](./README.md#available-flags-for-the-args-option)
|
|
57
|
+
- [Configure Orgs](./README.md#configure-orgs)
|
|
58
|
+
- [Configure Toolsets](./README.md#configure-toolsets)
|
|
59
|
+
- [Configure Tools](./README.md#configure-tools)
|
|
55
60
|
- When writing the `args` option, surround both the flag names and their values in double quotes, and separate all flags and values with commas. Some flags are Boolean and don't take a value.
|
|
56
61
|
- The preceding example shows three flags that take a string value (`--orgs`, `--toolsets`, and `--tools`) and one Boolean flag (`--allow-non-ga-tools`). This configuration starts a DX MCP Server that enables all the MCP tools in the `orgs`, `metadata`, `data`, and `users` toolsets and a specific tool called `run_apex_tests`. It also enables tools in these configured toolsets that aren't yet generally available.
|
|
57
62
|
|
|
58
|
-
|
|
59
|
-
<summary>Reference: MCP Client Configurations</summary>
|
|
60
|
-
|
|
61
|
-
## MCP Client Configurations
|
|
63
|
+
## MCP Client Configurations
|
|
62
64
|
|
|
63
65
|
Here are examples of configuring the Salesforce DX MCP Server in various MCP clients.
|
|
64
66
|
|
|
@@ -124,10 +126,6 @@ For these other clients, refer to their documentation for adding MCP servers and
|
|
|
124
126
|
- [Zed](https://github.com/zed-industries/zed)
|
|
125
127
|
- [Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en)
|
|
126
128
|
|
|
127
|
-
</details>
|
|
128
|
-
<details>
|
|
129
|
-
<summary>Reference: Available Flags for the `args` Option</summary>
|
|
130
|
-
|
|
131
129
|
## Available Flags for the "args" Option
|
|
132
130
|
|
|
133
131
|
These are the flags that you can pass to the `args` option.
|
|
@@ -142,11 +140,6 @@ These are the flags that you can pass to the `args` option.
|
|
|
142
140
|
| `--allow-non-ga-tools` | Boolean flag to allow the DX MCP Server to use both the generally available (GA) and NON-GA tools that are in the toolsets or tools you specify. | No | By default, the DX MCP server uses only the tools marked GA. |
|
|
143
141
|
| `--dynamic-tools` | (experimental) Boolean flag that enables dynamic tool discovery and loading. When specified, the DX MCP server starts with a minimal set of core tools and loads new tools as needed. | No| This flag is useful for reducing the initial context size and improving LLM performance. Dynamic tool discovery is disabled by default.<br/> <br/>**NOTE:** This feature works in VSCode and Cline but may not work in other environments.|
|
|
144
142
|
|
|
145
|
-
</details>
|
|
146
|
-
<details>
|
|
147
|
-
|
|
148
|
-
<summary>Reference: Configure Orgs</summary>
|
|
149
|
-
|
|
150
143
|
## Configure Orgs
|
|
151
144
|
|
|
152
145
|
The Salesforce MCP tools require an org, and so you must include the required `--orgs` flag to specify at least one authorized org when you configure the MCP server. Separate multiple values with commas.
|
|
@@ -162,11 +155,6 @@ These are the available values for the `--orgs` flag:
|
|
|
162
155
|
| `ALLOW_ALL_ORGS` | Allow access to all authorized orgs. Use this value with caution.|
|
|
163
156
|
| `<username or alias>` | Allow access to a specific org by specifying its username or alias.|
|
|
164
157
|
|
|
165
|
-
</details>
|
|
166
|
-
|
|
167
|
-
<details>
|
|
168
|
-
<summary>Reference: Configure Toolsets and Tools</summary>
|
|
169
|
-
|
|
170
158
|
## Configure Toolsets
|
|
171
159
|
|
|
172
160
|
The Salesforce DX MCP Server supports **toolsets** - a way to selectively enable different groups of MCP tools based on your needs. This allows you to run the MCP server with only the tools you require, which in turn reduces the context.
|
|
@@ -181,6 +169,7 @@ These are the available toolsets.
|
|
|
181
169
|
| `aura-experts` | [Tools which provides Aura component analysis, blueprinting, and migration expertise.](README.md#aura-experts-toolset)|
|
|
182
170
|
| `code-analysis` | [Tools for static analysis of your code using Salesforce Code Analyzer](README.md#code-analysis-toolset)|
|
|
183
171
|
| `data` | [Tools to manage the data in your org, such as listing all accounts.](README.md#data-toolset)|
|
|
172
|
+
| `enrichment` | [Tools to enrich metadata for components in your org.](README.md#enrichment-toolset)|
|
|
184
173
|
| `lwc-experts` | [Tools to assist with LWC development, testing, optimization, and best practices.](README.md#lwc-experts-toolset)|
|
|
185
174
|
| `metadata` | [Tools to deploy and retrieve metadata to and from your org and your DX project.](README.md#metadata-toolset)|
|
|
186
175
|
| `mobile` | [Tools for mobile development and capabilities.](README.md#mobile-toolset)|
|
|
@@ -289,6 +278,7 @@ Orchestrates the complete Aura to LWC migration workflow. Provides end-to-end gu
|
|
|
289
278
|
- `guide_utam_generation` - (NON-GA) Provides UTAM Page Object generation guidelines and best practices.
|
|
290
279
|
- `create_lightning_type` - (GA) Provides guidance for creating Custom Lightning Types (CLT) for Salesforce applications,
|
|
291
280
|
* Einstein Agent actions, Lightning Web Components, and Lightning Platform integrations.
|
|
281
|
+
|
|
292
282
|
#### Workflow Tools
|
|
293
283
|
|
|
294
284
|
- `orchestrate_lwc_component_creation` - (GA) Step-by-step component creation workflow guidance
|
|
@@ -323,4 +313,8 @@ Orchestrates the complete Aura to LWC migration workflow. Provides end-to-end gu
|
|
|
323
313
|
|
|
324
314
|
- `scan_apex_class_for_antipatterns` - (NON-GA) Analyzes Apex class files for performance antipatterns and provides recommendations for fixing them. Currently detects: (1) Schema.getGlobalDescribe() usage with optimized alternatives, (2) SOQL queries without WHERE or LIMIT clauses, (3) SOQL queries with unused fields (with fix generation). Distinguishes between different severity levels (e.g., usage in loops vs. ordinary usage). Requires an absolute path to the Apex class file.
|
|
325
315
|
|
|
316
|
+
### Enrichment Toolset
|
|
317
|
+
|
|
318
|
+
- `enrich_metadata` - (NON-GA) Enrich metadata from your org in your DX project.
|
|
319
|
+
|
|
326
320
|
</details>
|
package/lib/registry.js
CHANGED
|
@@ -20,6 +20,7 @@ import { AuraExpertsMcpProvider } from '@salesforce/mcp-provider-aura-experts';
|
|
|
20
20
|
import { MobileWebMcpProvider } from '@salesforce/mcp-provider-mobile-web';
|
|
21
21
|
import { DevOpsMcpProvider } from '@salesforce/mcp-provider-devops';
|
|
22
22
|
import { ScaleProductsMcpProvider } from '@salesforce/mcp-provider-scale-products';
|
|
23
|
+
import { EnrichMetadataMcpProvider } from '@salesforce/mcp-provider-metadata-enrichment';
|
|
23
24
|
/** -------- ADD McpProvider INSTANCES HERE ------------------------------------------------------------------------- */
|
|
24
25
|
export const MCP_PROVIDER_REGISTRY = [
|
|
25
26
|
new DxCoreMcpProvider(),
|
|
@@ -29,6 +30,7 @@ export const MCP_PROVIDER_REGISTRY = [
|
|
|
29
30
|
new MobileWebMcpProvider(),
|
|
30
31
|
new DevOpsMcpProvider(),
|
|
31
32
|
new ScaleProductsMcpProvider(),
|
|
33
|
+
new EnrichMetadataMcpProvider(),
|
|
32
34
|
// Add new instances here
|
|
33
35
|
];
|
|
34
36
|
//# sourceMappingURL=registry.js.map
|