mcp-server-sfmc 0.1.0 → 0.1.5

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 (2) hide show
  1. package/README.md +20 -2
  2. package/package.json +6 -2
package/README.md CHANGED
@@ -4,6 +4,24 @@ MCP server providing Salesforce Marketing Cloud language intelligence — AMPscr
4
4
 
5
5
  Built on [sfmc-language-lsp](https://github.com/JoernBerkefeld/sfmc-language-lsp), the same engine that powers the [SFMC Language Service VS Code extension](https://marketplace.visualstudio.com/items?itemName=joernberkefeld.sfmc-language).
6
6
 
7
+ ## VS Code without manual MCP config
8
+
9
+ If you use the **SFMC Language Service** extension (**1.101+**), it registers this MCP server for discovery in VS Code — you normally do **not** need to edit `.vscode/mcp.json` or run `npm install` for that path; VS Code still launches the published package via `npx` when the server starts.
10
+
11
+ For **other editors**, or if you prefer explicit configuration, use the `npx` or install options below.
12
+
13
+ ## Using this package without the VS Code extension
14
+
15
+ You **do not** have to install the VS Code extension. Pick one way to run the server:
16
+
17
+ | Approach | When to use it |
18
+ |---|---|
19
+ | **`npx` (no install)** | Default in the examples below. Runs the latest published version from npm on demand; first run may download the package. **Requires Node.js and npm** (which provides `npx`). |
20
+ | **`npm install -g mcp-server-sfmc`** | Same CLI as `npx`, but the package stays on disk so **startup is faster** and you can set `"command": "mcp-server-sfmc"` with empty `args` in your MCP config. |
21
+ | **`npm install mcp-server-sfmc` in a project** | Keeps a **pinned version** in that folder’s `node_modules` — point your MCP config at `npx mcp-server-sfmc` with `cwd` set to the project, or run `./node_modules/.bin/mcp-server-sfmc` directly. |
22
+
23
+ None of these replace the VS Code extension for **editing** (syntax, LSP, snippets); they only expose the **MCP server** to tools that speak the Model Context Protocol.
24
+
7
25
  ## What it gives your AI assistant
8
26
 
9
27
  | Feature | Details |
@@ -18,9 +36,9 @@ Built on [sfmc-language-lsp](https://github.com/JoernBerkefeld/sfmc-language-lsp
18
36
 
19
37
  ## Quick start
20
38
 
21
- ### VS Code (1.99+) + GitHub Copilot
39
+ ### VS Code (1.99+) + GitHub Copilot — manual `mcp.json`
22
40
 
23
- Add a `.vscode/mcp.json` file to your project (or copy it from this repo):
41
+ If you are **not** using the SFMC Language Service extension’s built-in MCP registration, add a `.vscode/mcp.json` file to your project (or copy it from this repo):
24
42
 
25
43
  ```json
26
44
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-server-sfmc",
3
- "version": "0.1.0",
3
+ "version": "0.1.5",
4
4
  "description": "MCP server for Salesforce Marketing Cloud — exposes SFMC language intelligence (AMPscript, SSJS, GTL) as Model Context Protocol tools, resources, and prompts for AI-assisted development and code review.",
5
5
  "author": "Jörn Berkefeld",
6
6
  "license": "MIT",
@@ -38,6 +38,7 @@
38
38
  "LICENSE"
39
39
  ],
40
40
  "scripts": {
41
+ "prepublishOnly": "npm run build",
41
42
  "build": "tsc -p tsconfig.json",
42
43
  "dev": "tsc -p tsconfig.json --watch",
43
44
  "start": "node dist/index.js",
@@ -46,9 +47,12 @@
46
47
  },
47
48
  "dependencies": {
48
49
  "@modelcontextprotocol/sdk": "^1.29.0",
49
- "sfmc-language-lsp": "file:../sfmc-language-lsp"
50
+ "sfmc-language-lsp": "^0.1.3"
50
51
  },
51
52
  "engines": {
52
53
  "node": ">=18.0.0"
54
+ },
55
+ "devDependencies": {
56
+ "@types/node": "^22.19.17"
53
57
  }
54
58
  }