SearchAtlas MCP Server

SearchAtlas MCP服务器

](https://www.npmjs.com/package/searchatlas-mcp-server)   ](https://nodejs.org)

** · MCP注册表 · **

将任何兼容MCP的AI客户端连接到 SearchAtlas v2 MCP服务器 --500多种工具，涵盖OTTO SEO、PPC、Content Genius、Site Explorer、Google Business Profile、本地SEO、链接实验室、数字公关、LLM可见性、关键字研究等。

此包作为一个精简的stdio桥运行到位于的托管v2 MCP服务器 https://mcp.searchatlas.com/mcp/ 因此，它适用于只讲stdio的客户端。具有本机Streamable HTTP支持的客户端可以直接连接到远程端点。

使用 克劳德代码、光标、克劳德桌面、VS代码、Windsurf和Zed.

______________________________________________________________________

设置（3个步骤）

1.安装并登录

使用npm：

npm install -g searchatlas-mcp-server
searchatlas login

使用纱线：

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 （或 Cmd+选项+I 在Mac上）打开DevTools
2. 首选 控制台 标签
3. 运行： localStorage.getItem("token")
4. 复制结果并将其粘贴到终端中

CLI验证您的令牌，保存它，然后 打印准备粘贴的配置，自动检测您的路径.

2.添加到您的MCP客户端

克劳德代码

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/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 打印出来——它有你的确切路径。

克劳德桌面

添加 ~/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。

Windsurf

添加 ~/.codeium/windsurf/mcp_config.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"
      }
    }
  }
}

VS Code (GitHub Copilot)

添加 .vscode/mcp.json 在您的项目中：

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

Zed

添加到Zed settings.json:

{
  "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 GUI应用程序（光标、克劳德桌面、VS代码、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 .

______________________________________________________________________

工具

工具是从托管的v2 MCP服务器动态发现的——您的客户端可以看到实时目录（目前约587个工具），而无需在新工具发货时进行软件包更新。主要群体：

跑 searchatlas check 查看实时计数，或在连接后要求您的MCP客户端列出工具。

______________________________________________________________________

配置

令牌优先级（第一场比赛获胜）

1. SEARCHATLAS_TOKEN env 是
2. SEARCHATLAS_API_KEY env 是
3. ~/.searchatlasrc 文件（由创建 searchatlas login)

环境变量

原生流式HTTP客户端

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

• 统一资源定位符: https://mcp.searchatlas.com/mcp/
• 运输：流式HTTP（JSON-RPC+SSE）
• 头球: Authorization: Bearer

______________________________________________________________________

故障排除

还在卡住吗？ 跑 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检验员测试：

npx @modelcontextprotocol/inspector npx searchatlas-mcp-server

______________________________________________________________________

需求

• Node.js >= 18
• A. 搜索Atlas帐户 — 在这里注册

许可证

麻省理工学院