项目简介

Serpstat MCP 服务器是一个基于TypeScript构建的后端应用，旨在通过Model Context Protocol (MCP) 标准，使AI助手（如Claude）能够安全、便捷地访问Serpstat强大的SEO分析功能。它将复杂的SEO数据和工具封装为LLM可调用的接口，帮助AI在对话中提供精确的SEO信息和建议。

主要功能点

全面的SEO分析能力: 涵盖域名信息、关键词研究、竞争对手分析和反向链接数据等。
强大的工具集: 提供数十种与Serpstat API交互的工具，包括获取域名关键词、分析反向链接概况、执行网站审计、管理项目、查询API信用等。
类型安全与验证: 使用TypeScript提供全程类型安全，并通过Zod库进行参数验证，确保数据输入的健壮性。
灵活的配置: 支持通过环境变量进行配置，方便在不同环境中部署。
日志记录: 集成Winston进行详细的事件日志记录，便于调试和监控。
兼容性: 专为Anthropic的MCP设计，兼容Claude Desktop、Gemini CLI等遵循MCP标准的AI客户端。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js 18.0.0 或更高版本。您可以从 Node.js 官网下载安装。
获取 Serpstat API Token: 您需要一个有效的 Serpstat API Token 才能使用此服务器。请访问 Serpstat API 页面获取。
全局安装服务器: 推荐使用 npm 全局安装，这使得服务器命令可以在任何位置被AI客户端调用。
```
npm install -g @serpstat/serpstat-mcp-server
```
如果偏好本地安装，请使用 'npm install @serpstat/serpstat-mcp-server'。

服务器配置（LLM客户端端配置）

MCP 服务器本身通过环境变量配置，但您的AI客户端需要知道如何启动并连接到这个服务器。以下是如何在兼容MCP的AI客户端中配置此服务器的示例：

在您的AI客户端配置文件中（例如，Claude Desktop 的 '~/Library/Application Support/Claude/claude_desktop_config.json' 或 Gemini CLI 的 '~/.gemini/settings.json'），添加以下 'mcpServers' 配置块。请将 'YOUR_SERPSTAT_API_TOKEN_HERE' 替换为您实际的 Serpstat API Token。

{
   "mcpServers": {
      "serpstat": {
         "command": "npx",
         "args": ["-y", "@serpstat/serpstat-mcp-server"],
         "env": {
            "SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE", // 您的Serpstat API Token
            "LANG": "en_US.UTF-8", // 推荐设置，确保字符编码一致性
            "LC_ALL": "en_US.UTF-8", // 推荐设置，确保字符编码一致性
            "LOG_LEVEL": "info" // （可选）服务器日志级别：error, warn, info, debug。默认 error
         }
      }
   }
}

配置说明:

'"serpstat"': 您为该MCP服务器定义的唯一名称，AI助手将使用此名称来识别和调用其工具。
'"command": "npx"': 指定用于启动MCP服务器的命令。'npx' 会在您的系统中查找并执行已安装的npm包。
'"args": ["-y", "@serpstat/serpstat-mcp-server"]': 传递给 'command' 的参数。'-y' 选项用于自动确认安装（如果包未找到）。'@serpstat/serpstat-mcp-server' 是您安装的MCP服务器包的名称。
'"env"': 环境变量配置。
- '"SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE"': 必须配置。替换为您的Serpstat API Token。这是服务器连接Serpstat API的关键。
- '"LANG": "en_US.UTF-8"', '"LC_ALL": "en_US.UTF-8"': 推荐设置，确保字符编码一致性。
- '"LOG_LEVEL": "info"': （可选）设置服务器的日志级别，可为 'error', 'warn', 'info', 'debug'。默认 'error'。

基本使用方法

配置完成后，重启您的AI客户端。现在您可以通过自然语言向AI助手提问，让它调用Serpstat工具来获取SEO数据。

例如，您可以这样询问：

"Show me domain info for example.com" (显示example.com的域名信息)
"Find competitors for my-site.com in Google US" (在Google美国搜索my-site.com的竞争对手)
"Get top 50 keywords that example.com ranks for" (获取example.com排名前50的关键词)
"Get comprehensive keyword data for ['iphone', 'samsung', 'google pixel'] including search volume, CPC, and difficulty" (获取包含搜索量、CPC和难度的'iphone', 'samsung', 'google pixel'的综合关键词数据)
"Analyze backlinks summary for domain.com" (分析domain.com的反向链接摘要)
"Create a new project for example.com named My SEO Project" (为example.com创建一个名为"My SEO Project"的新项目)
"Check my API credits usage and remaining quota" (检查我的API信用使用情况和剩余配额)

AI助手会理解您的意图，自动调用相应的Serpstat工具，并将结果以易于理解的方式呈现给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置（LLM客户端端配置）

基本使用方法

信息