Ember MCP Server

How to use

Interact with the MCP server through your MCP client to search Ember documentation, fetch API references, and explore best practices. Use the search tool to find topics across guides, API docs, and community content. Retrieve detailed API information for specific Ember classes or modules. Get guidance on modern Ember patterns and migration considerations. The server is designed to detect your workspace’s package manager and provide commands that match your project setup, ensuring you can execute changes safely within your environment.

How to install

Prerequisites you need before running the MCP server: Node.js 22 or higher and any MCP-compatible client.

Install and run using the latest release configuration in your workspace. Use one of the example server configurations shown below to start the MCP server within your editor or development environment.

{
  "servers": {
    "ember": {
      "command": "npx",
      "args": ["-y", "ember-mcp"]
    }
  }
}

Configuration and running

If you need to ensure a specific shell environment, you can wrap the MCP command in a shell invocation. The example below shows how to run the MCP through a Bash shell explicitly.

{
  "servers": {
    "ember": {
      "command": "/opt/homebrew/bin/bash",
      "args": ["-l", "-c", "pnpm dlx ember-mcp"]
    }
  }
}

Additional deployment options

If you want to use a tag-release from GitHub, you can point the MCP server to a specific release of the package. The example demonstrates using a GitHub-backed release with npx.

{
  "servers": {
    "ember": {
      "command": "npx",
      "args": ["-y", "github:NullVoxPopuli/ember-mcp#v0.0.2-ember-mcp"]
    }
  }
}

Development and local setup

If you prefer running the MCP server from a local checkout, clone the repository, install dependencies, and follow the project’s run commands. When configuring your editor, place the server configuration in your Claude Desktop or editor-specific MCP settings to enable seamless integration.

cd ember-mcp
npm install

Starting the server in development mode

To run the server in development mode, use the development script to enable automatic restarts during development.

npm run dev

Notes on usage in your editor

VSCode uses the servers key for MCP servers, while Claude desktop uses mcpServers. Ensure your editor or tool is configured to load the MCP server using the appropriate configuration section.

Troubleshooting

If the MCP server does not appear in your editor, verify that the path to your configuration is absolute and correct, ensure Node.js is accessible in your PATH, check your editor logs for MCP-related messages, and restart the editor entirely.

If documentation or data fails to load, confirm that you have an active internet connection and that the documentation source URL is accessible. Review server logs for errors.

If search results are empty, broaden your search terms, use the category filter to narrow results, and check for correct spelling of API names.

search_ember_docs

Search Ember documentation including API docs, guides, and community content.

get_api_reference

Get detailed API documentation for a specific Ember class, module, or method.

get_best_practices

Fetch Ember best practices and recommendations for specified topics.

get_ember_version_info

Retrieve information about Ember versions, including migration guides.

get_npm_package_info

Retrieve comprehensive information about an npm package, including versions and dependencies.

compare_npm_versions

Compare a current npm package version with the latest available version.

detect_package_manager

Detect the workspace's package manager and provide correct commands for installation and scripts.