io.github.JoernBerkefeld/mcp-server-mcdev
mcdev MCP: wiki search, .mcdevrc help, journey checklists, metadata types via mcdev.
Open source Open in the app JSON README (API)
About
mcdev MCP: wiki search, .mcdevrc help, journey checklists, metadata types via mcdev.
Details
- Kind
- MCP servers
- Topic
- Productivity
- Publisher
- joernberkefeld
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 1
- Open pull requests
- 11
- Last push
- 2026-08-10T16:36:24Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:59
- Updated
- 2026-08-29 03:01:59
- Origin id
io.github.JoernBerkefeld/mcp-server-mcdev
README
# mcp-server-mcdev
MCP (Model Context Protocol) server for **[Accenture SFMC DevTools](https://github.com/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](https://www.npmjs.com/package/mcp-server-sfmc)** for AMPscript / SSJS language validation and lookups.
## MCP Registry
Registered as **`io.github.JoernBerkefeld/mcp-server-mcdev`** ([quickstart](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx)). 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](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/github-actions.mdx)) — 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`
```json
{
"servers": {
"mcdev": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-server-mcdev@latest"]
}
}
}
```
### Cursor — `~/.cursor/mcp.json` or project `.cursor/mcp.json`
```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)
```bash
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](https://marketplace.visualstudio.com/items?itemName=Accenture-oss.sfmc-devtools-vscode)** 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`):
```bash
npm run bundle-wiki
npm run build
```
## License
MIT © Jörn Berkefeld