Registry / ai-ml / migration-accelerator-mcp

migration-accelerator-mcp

library1.0.4jsnpmunverified

An MCP (Model Context Protocol) server that exposes the Migration Accelerator platform's full capabilities to AI assistants like Claude. Version 1.0.4, released periodically on npm. Provides 40+ migration tools including snapshots, page creation, publishing, and AI-powered mapping. Supports both stdio (for Claude Desktop) and HTTP/SSE (for web integrations) transports. Requires API key authentication with scopes and rate limiting. Ships TypeScript types. Requires Node.js >=20.0.0. Differentiators: built specifically for Magnolia CMS migrations, combines MCP protocol with real migration workflows, and includes AI/RAG tools like knowledge retrieval and component mapping.

ai-ml devops

npm install migration-accelerator-mcp

package ↗

INSTALL

IMPORT

SIG · MIGRATION-ACCELERA

migration-accelerator-mcp

ai-mljavascriptv1.0.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

main

✓ npx @noice-work/migration-accelerator-mcp

✗ require('@noice-work/migration-accelerator-mcp')

This package is primarily used as a CLI tool, not as a library import. Use npx or install globally and run directly.

Server

✓ import { Server } from '@noice-work/migration-accelerator-mcp'

✗ import Server from '@noice-work/migration-accelerator-mcp'

The Server class is a named export. Default export is not available. TypeScript types included.

types

✓ import type { SiteConfig, PlatformConfig } from '@noice-work/migration-accelerator-mcp'

✗ const { SiteConfig } = require('@noice-work/migration-accelerator-mcp')

Types are exported from the package. Use type import syntax for cleaner code.

Shows how to configure the MCP server in Claude Desktop to expose migration tools to the AI assistant.

// In Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json): { "mcpServers": { "migration-accelerator": { "command": "npx", "args": ["@noice-work/migration-accelerator-mcp"], "env": { "MCP_API_KEY": "mcp_your_key_here" } } } } // Then ask Claude: // "List my migration sites" // "Snapshot the homepage of my site"

Debug

Known issues

gotchaRequires Node.js >=20.0.0 — older versions will fail to run.

fix

Upgrade Node.js to version 20 or later.

affects: <20.0.0

gotchaAPI key must be provided via MCP_API_KEY environment variable; passing via CLI args may expose key in process list.

fix

Always use environment variable MCP_API_KEY or secure secret management; never pass API key as a command line argument.

affects: all

gotchaThe stdio transport is default for Claude Desktop; HTTP/SSE transport requires explicit --transport http flag and may have CORS issues.

fix

For web integrations, set --transport http and configure CORS headers on your server if needed.

affects: all

deprecatedSome tool names like 'agents_createSnapshot' use underscore naming; future versions may switch to camelCase.

fix

Monitor changelog for tool renaming and update your prompts accordingly.

affects: 1.0.x

Errors

Common errors & fixes

Error: Cannot find module '@noice-work/migration-accelerator-mcp'

The package is not installed or npx is not available.

fix

Run: npm install -g @noice-work/migration-accelerator-mcp or use npx with the correct package name.

Error: MCP_API_KEY environment variable not set

The API key was not provided when starting the server.

fix

Set the MCP_API_KEY environment variable before running the command: export MCP_API_KEY=mcp_xxx

TypeError: Cannot read properties of undefined (reading 'stdin')

Running the stdio transport in an environment without a proper TTY (e.g., in a script without stdin).

fix

Use --transport http for non-interactive environments, or ensure stdin is available.

Error: listen EADDRINUSE :::3001

Port 3001 is already in use when using HTTP transport.

fix

Change the port with --port <alternative_port> or kill the existing process using port 3001.

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

@modelcontextprotocol/sdkrequiredCore MCP protocol implementation

Agent activity

9 hits · last 30 days

node

Amazon

Resources

packagemigration-accelerator-mcp ↗