MCP Server

Installation

Getting a copy of the project

Save a copy of the project to a local directory, for example /path/to/seo-data-api-mcp-server.

Set up environment variables

The SE Ranking Data API access key is set via an environment variable, which can be done globally or through the Claude Desktop configuration.

export SERANKING_API_TOKEN=your-token-here

Option 1: Installation as an NPM package

Prerequisites

• Node.js 18+

cd /path/to/seo-data-api-mcp-server
npm install
npm run build
# Check that the build starts successfully and press Ctrl+C to stop it.
npm start

Option 2: Build the Docker Image

Prerequisites

• Docker, Docker Compose

cd /path/to/seo-data-api-mcp-server
docker compose build
# Check that the image is built and named `se-ranking/seo-data-api-mcp-server`:
docker image ls

Connect to Claude Desktop

Claude Desktop reads its configuration from claude_desktop_config.json.

• Click on the Claude menu and select “Settings…”.
• In the Settings window, navigate to the “Developer” tab in the left sidebar.
• Click the “Edit Config” button to open the configuration file. This action creates a new configuration file if one doesn’t exist, or opens your existing configuration.

The file is located at:

• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %AppData%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Example of Claude Desktop configuration for MCP server, running via Node:

{
  "mcpServers": {
    "se-ranking/seo-data-api-mcp-server": {
      "command": "node",
      "args": ["/path/to/seo-data-api-mcp-server/dist/index.js"],
      "env": {
        "SERANKING_API_TOKEN": "your-token-here"
      }
    }
  }
}

Example of Claude Desktop configuration for MCP server, running via docker image:

{
  "mcpServers": {
    "se-ranking/seo-data-api-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERANKING_API_TOKEN",
        "se-ranking/seo-data-api-mcp-server"
      ],
      "env": {
        "SERANKING_API_TOKEN": "your-token-here"
      }
    }
  }
}

After saving claude_desktop_config.json, restart Claude Desktop. You should see the server under MCP Servers/Tools.