mcp-server-mcdev
MCP (Model Context Protocol) server for Accenture SFMC DevTools (mcdev): search the project wiki offline, learn .mcdevrc.json concepts (markets, marketList, createDeltaPkg, validations), walk component checklists (e.g. journeys), and list metadata types via the installed mcdev package.
Pair with mcp-server-sfmc for AMPscript / SSJS language validation and lookups.
MCP Registry
Registered as io.github.JoernBerkefeld/mcp-server-mcdev (quickstart). Registry hosts metadata only; the server runs locally via stdio.
Verify after publish:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.JoernBerkefeld/mcp-server-mcdev"
CI publishes npm artifacts and registry metadata using GitHub OIDC (Actions doc) — see .github/workflows/npm-publish.yml.
Tools
| Tool | Purpose |
|---|---|
mcdev_search_docs | Search bundled sfmc-devtools wiki Markdown |
mcdev_explain_config_key | Short explanations for config topics (markets, marketList, createDeltaPkg, …) |
mcdev_component_checklist | Questions + dependent metadata types (journey, automation, …) |
mcdev_list_metadata_types | Types from Mcdev.explainTypes() (silent JSON mode — safe for MCP stdio) |
read_mcdev_project_config | Read .mcdevrc.json with credentials stripped (never reads .mcdev-auth.json) |
Connecting AI clients
Register mcp-server-mcdev with the same patterns as other stdio MCP servers (package name in args).
VS Code (1.99+) — .vscode/mcp.json
{
"servers": {
"mcdev": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-server-mcdev@latest"]
}
}
}
Cursor — ~/.cursor/mcp.json or project .cursor/mcp.json
{
"mcpServers": {
"mcdev": {
"command": "npx",
"args": ["-y", "mcp-server-mcdev@latest"]
}
}
}
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) — use the same mcpServers object shape as Cursor.
Windsurf
~/.codeium/windsurf/mcp_config.json — same mcpServers shape as Cursor.
Global install (faster startup)
npm install -g mcp-server-mcdev
Then use "command": "mcp-server-mcdev", "args": [] (or the binary name from this package’s bin field).
SFMC DevTools VS Code extension
The SFMC DevTools extension documents optional MCP setup for AI-assisted mcdev workflows (see that repo’s README).
Refresh bundled wiki
From this package directory, with the wiki checkout next to the repo (or set SFMC_DEVTOOLS_WIKI):
npm run bundle-wiki
npm run build
License
MIT © Jörn Berkefeld