SearchAtlas

SearchAtlas MCP 服务

npm · MCP Registry · GitHub

将任何兼容 MCP 的 AI 客户端连接到 SearchAtlas v2 MCP 服务——提供 500 多种工具，涵盖 OTTO SEO、PPC、Content Genius、Site Explorer、Google Business Profile、本地 SEO、Link Laboratory、Digital PR、LLM 可见度、关键词研究等。

此软件包作为精简的 stdio 桥接程序运行，连接到托管的 v2 MCP 服务 https://mcp.searchatlas.com/mcp/，因此可与仅支持 stdio 的客户端配合使用。支持原生 Streamable-HTTP 的客户端可以直接连接远程端点。

适用于 Claude Code、Cursor、Claude Desktop、VS Code、Windsurf 和 Zed。

设置（3 步）

1. 安装并登录

使用 npm：

npm install -g searchatlas-mcp-server
searchatlas login

使用 yarn：

yarn global add searchatlas-mcp-server
searchatlas login

使用 pnpm：

pnpm add -g searchatlas-mcp-server
searchatlas login

无需安装（npx）：

npx searchatlas-mcp-server login

这会打开浏览器。登录后：

1. 按 F12（或在 Mac 上按 Cmd+Option+I）打开开发者工具
2. 转到 Console 选项卡
3. 运行：localStorage.getItem("token")
4. 复制结果并粘贴到终端

CLI 会验证你的令牌、保存令牌，并打印可直接粘贴的配置，自动检测你的路径。

2. 添加到 MCP 客户端

Claude Code

macOS / Linux：

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx -y searchatlas-mcp-server

Windows（PowerShell）：

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx.cmd -y searchatlas-mcp-server

Windows 注意事项： 必须使用 npx.cmd 而不是 npx。这是因为 Claude Code 会直接生成进程，而 Windows 要求使用 .cmd 扩展名。

完成。就这么简单。

Cursor

在项目根目录创建 .cursor/mcp.json（全局配置则创建 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

你的路径可能不同。 运行 which node 和 npm root -g 来查找路径，或者直接复制 searchatlas login 打印的配置——其中包含你的准确路径。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

保存后重启 Claude Desktop。

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

{
  "servers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

{
  "context_servers": {
    "searchatlas": {
      "command": {
        "path": "/opt/homebrew/bin/node",
        "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
        "env": {
          "SEARCHATLAS_TOKEN": "your-token"
        }
      }
    }
  }
}

3. 验证

searchatlas check

  SearchAtlas MCP Server — Health Check

  ✓ Credential source: ~/.searchatlasrc
  ✓ Config loaded successfully (endpoint: https://mcp.searchatlas.com/mcp)
  ✓ JWT structure valid (expires in 12 days) — user 42
  ✓ MCP handshake succeeded — 587 tools available

  All checks passed — you're ready to go!

为什么要使用完整路径？

macOS 图形界面应用（Cursor、Claude Desktop、VS Code、Windsurf、Zed）不会继承 shell 的 PATH，因此无法找到 node 或 npx。使用 node 的完整路径，并直接指向已安装的软件包，可以完全避免 spawn npx ENOENT 和 env: node: No such file 错误。

searchatlas login 会自动检测路径，并打印可供复制粘贴的配置。

用法

像平常一样自然地交流即可。AI 会选择合适的工具：

"What are the top SEO issues for my site?"
"Run a technical SEO audit on example.com"
"Write a blog post about technical SEO best practices"
"Find long-tail keywords for project management software"
"List my projects"
"Show available playbooks and run one"

CLI 命令

所有命令也可以通过 npx searchatlas-mcp-server <command> 运行。

工具

工具会从托管的 v2 MCP 服务动态发现——无需在新工具发布时更新软件包，客户端即可看到实时目录（目前约有 587 个工具）。主要分组如下：

运行 searchatlas check 查看实时数量，或连接后让 MCP 客户端列出工具。

配置

令牌优先级（使用第一个匹配项）

1. SEARCHATLAS_TOKEN 环境变量
2. SEARCHATLAS_API_KEY 环境变量
3. ~/.searchatlasrc 文件（由 searchatlas login 创建）

环境变量

原生 Streamable-HTTP 客户端

如果你的 MCP 客户端直接支持 Streamable HTTP，可以跳过此 npm 软件包，一步连接到远程服务：

• URL：https://mcp.searchatlas.com/mcp/
• 传输方式：Streamable HTTP（JSON-RPC + SSE）
• 标头：Authorization: Bearer <SEARCHATLAS_TOKEN>

故障排除

仍然无法解决？ 运行 searchatlas check，确认 Node.js >= 18（node --version），或提交问题。

开发

git clone https://github.com/Search-Atlas-Group/searchatlas-mcp-server.git
cd searchatlas-mcp-server
npm install && npm run build

使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector npx searchatlas-mcp-server

Requirements

• Node.js >= 18
• A SearchAtlas account — sign up here

License

MIT