使用说明

SearchAtlas 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

这将打开您的浏览器。登录后：

按 F12 （或 Cmd+选项+I 在Mac上）打开DevTools
首选 控制台 标签
运行： localStorage.getItem("token")
复制结果并将其粘贴到终端中

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 自动检测您的路径并打印您可以复制粘贴的配置。

如何找到你的路径	命令
完整路径 `node`	`which node`
全局npm模块目录	`npm root -g`

用法

自然地说话。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命令

命令	描述
`searchatlas login`	登录、保存令牌、打印MCP配置
`searchatlas check`	验证凭据+API连接
`searchatlas --version`	打印版本
`searchatlas --help`	显示帮助

所有命令也通过以下方式工作 npx searchatlas-mcp-server <command>.

工具

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

前缀	区域	代表性工具
`otto_*`	OTTO SEO自动化（70个工具）	`otto_list_projects`, `otto_add_site`, `otto_get_dynamic_optimizations`
`ppc_*`	谷歌广告/PPC（76个工具）	`ppc_list_accounts`, `ppc_create_campaign`, `ppc_get_keyword_performance`
`cg_*`	内容天才（74工具）	`cg_list_articles`, `cg_edit_article_content`, `cg_generate_content_brief`
`se_*`	网站浏览器（46工具）	`se_list_sites`, `se_get_details`, `se_backlinks_overview`
`gbp_*`	谷歌商业概况（96个工具）	`gbp_get_business_categories`, `gbp_list_citation_submissions`
`local_seo_*`	本地SEO热图（19个工具）	`local_seo_heatmaps_get_heatmap_details`, `local_seo_heatmaps_get_rank`
`ll_*`	链接实验室（24个工具）	`ll_list_projects`, `ll_create_order`
`dpr_*`	数字公关（20种工具）	`dpr_list_campaigns`, `dpr_create_campaign`
`llmv_*`	LLM可见性（30个工具）	`llmv_list_projects`, `llmv_get_visibility_report`
`krt_*`	关键词排名跟踪（16个工具）	`krt_list_projects`, `krt_track_keywords`
`bv_*`	品牌库（25个工具）	`bv_list`, `bv_ask`, `bv_update_business_info`
`ws_*`	网站工作室（8个工具）	`ws_list_projects`, `ws_create_project`
`gsc_*`	谷歌搜索控制台（11个工具）	`gsc_get_sites`, `gsc_get_keyword_performance`
`social_hub_*`	社交中心（19个工具）	`social_hub_list_posts`, `social_hub_create_post`
`cs_*`	内容策略（12个工具）	`cs_list_templates`, `cs_create`
`kg_*`	知识图谱（7个工具）	`kg_list`, `kg_create_entity`
`dkn_*`	领域知识网络（7个工具）	`dkn_list_nodes`, `dkn_create`
`indexer_*`	索引器（6个工具）	`indexer_submit_batch`, `indexer_check_status`
`rb_*`	报表生成器（3个工具）	`rb_list_reports`, `rb_get_report_details`
`pr_*`	新闻稿（14个工具）	`pr_list`, `pr_write`, `pr_update`

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

配置

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

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

环境变量

变量	必填	描述
`SEARCHATLAS_TOKEN`	是	来自SearchAtlas的JWT代币
`SEARCHATLAS_API_KEY`	备选	API密钥验证
`SEARCHATLAS_API_URL`	否	自定义v2 MCP端点（默认值： `https://mcp.searchatlas.com/mcp`)

原生流式HTTP客户端

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

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

故障排除

错误	修复
`spawn npx ENOENT` / `env: node: No such file`	使用完整路径（请参见为什么是完整的路径？)或重新运行 `searchatlas login`
`spawn npx ENOENT` 在Windows上（克劳德代码）	使用 `npx.cmd` 而不是 `npx` --看克劳德代码设置
`No SearchAtlas credentials found`	快跑 `searchatlas login`
`Token expired on ...`	快跑 `searchatlas login` 换一个新的代币
`Authentication failed` （401）	令牌已过期--运行 `searchatlas login`
`fetch failed`	检查网络；跑 `searchatlas check`
工具未显示	添加配置后重新启动MCP客户端

还在卡住吗？ 跑 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帐户 — 在这里注册

许可证

麻省理工学院

使用说明

SearchAtlas MCP服务器

设置（3个步骤）

1.安装并登录

2.添加到您的MCP客户端

克劳德代码

光标

克劳德桌面

3.验证

为什么是完整的路径？

用法

CLI命令

工具

配置

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

环境变量

原生流式HTTP客户端

故障排除

发展

需求

许可证

相关 MCP

多模态生成API服务

Rhino与Grasshopper AI控制MCP服务

图表生成MCP服务器

Blender 3D建模MCP服务

Ableton Live AI音乐制作MCP服务器

图像生成服务