项目简介

SEO洞察 MCP服务器是一个基于 Model Context Protocol (MCP) 标准的应用后端，旨在将AI助手连接到外部SEO数据和功能。它通过提供结构化的工具，使AI能够执行域名分析、关键词研究和网站流量检查等任务，增强AI在SEO领域的应用能力。

主要功能点

本服务器提供以下核心SEO功能，AI助手可通过MCP调用：

反向链接分析： 获取指定域名的反向链接列表，了解其链接来源和质量。
关键词生成： 基于提供的种子关键词，生成相关的关键词建议及其重要指标（如搜索量、难度）。
关键词难度检查： 检查特定关键词的竞争难度，并提供相关的SERP（搜索引擎结果页）分析数据。
网站流量分析： 获取任意网站的估算搜索流量数据，包括流量趋势、热门页面、主要流量来源国家和关键词。

安装步骤

准备环境： 确保已安装 Node.js (>=18.x) 和 Git。

克隆仓库： 打开终端，使用 Git 克隆项目仓库：

git clone https://github.com/mrgoonie/seo-insights-mcp-server.git
cd seo-insights-mcp-server

安装依赖： 在项目根目录运行命令安装所需依赖：
```
npm install
```
配置API密钥： 本服务器需要 CAPSOLVER API 密钥来处理 CAPTCHA（验证码），尤其是在访问某些SEO数据时。请在 '.env' 文件中设置 'CAPSOLVER_API_KEY' 环境变量：
```
CAPSOLVER_API_KEY=your-capsolver-api-key
```
你也可以将此配置添加到 '$HOME/.mcp/configs.json' 文件中（推荐方式），使用 'seo-insights' 作为配置键：
```
{
  "seo-insights": {
    "environments": {
      "CAPSOLVER_API_KEY": "your-api-key"
    }
  }
}
```
（注意：如果服务器还需要其他API密钥，例如访问更高级的SEO数据，可能需要在 '.env' 文件或 MCP 配置中添加更多环境变量。）

服务器配置（用于 MCP 客户端）

MCP 客户端（如支持 MCP 的 AI 聊天界面或框架）需要配置如何连接和启动此服务器。以下是两种常见的配置示例（JSON格式，需添加到 MCP 客户端的配置文件中，通常是用户主目录下的 '.mcp/configs.json'）：

方式一：使用 StdIO 传输（适用于本地或CLI环境）

{
  "mcpServers": {
    "seo-insights": {
      // 服务器的唯一标识符，推荐使用简短且描述性的名称
      "name": "seo-insights",
      // 启动服务器进程的命令
      "command": "node",
      // 传递给命令的参数，这里指定了服务器的入口文件
      "args": ["/path/to/seo-insights-mcp-server/dist/index.js"],
      // 指定使用的传输协议，这里是标准输入输出
      "transportType": "stdio",
      // 可选：在此处配置环境变量，优先级低于 .env 和全局 ~/.mcp/configs.json
      "environments": {
        "CAPSOLVER_API_KEY": "your-api-key" 
      }
    }
  }
}

请将 '/path/to/seo-insights-mcp-server/dist/index.js' 替换为你实际安装服务器的路径。

方式二：使用 Streamable HTTP 传输（适用于本地或远程部署）

{
  "mcpServers": {
    "seo-insights": {
      // 服务器的唯一标识符
      "name": "seo-insights",
      // 指定传输类型为 HTTP
      "type": "http",
      // 服务器的 HTTP 地址，AI 客户端将连接此地址
      "url": "http://localhost:8080/mcp"
      // 可选：此处通常不需要配置 API Key 等环境变量，应在服务器部署时单独配置。
    }
  }
}

如果你将服务器部署在远程，需要将 'http://localhost:8080/mcp' 替换为实际的远程地址和端口。HTTP 服务器的地址和端口可以通过设置 'MCP_HTTP_HOST', 'MCP_HTTP_PORT', 'MCP_HTTP_PATH' 等环境变量来配置。

基本使用方法

启动服务器：

如果使用 StdIO 传输并在本地运行，通常由 MCP 客户端在需要时自动启动，无需手动操作。

如果使用 HTTP 传输，你需要在终端手动启动服务器：

# 使用 StdIO 传输启动 (通常由客户端调用)
# npm run dev:server 

# 使用 HTTP 传输启动
npm run dev:server:http
# 或者在生产模式下
# npm run start:server --transport http

在支持 MCP 的 AI 客户端中使用： 将上述服务器配置添加到你的 AI 客户端的 '.mcp/configs.json' 文件中。保存配置后，AI 客户端将识别并连接到 "seo-insights" 服务器。你现在可以通过与 AI 交互来使用这些功能，例如：
- 询问："请帮我获取 example.com 的反向链接列表。" (对应 'get_backlinks_list' 工具)
- 询问："研究一下关于 '最佳营销策略' 的关键词，面向英国市场。" (对应 'keyword_generator' 工具)
- 询问："请检查关键词 'SEO分析工具' 的难度。" (对应 'keyword_difficulty' 工具)
- 询问："分析一下 example.com 的网站流量。" (对应 'get_traffic' 工具)

AI 客户端会根据你的请求，自动调用配置好的 "seo-insights" MCP 服务器上的相应工具，并将结果呈现给你。

关键词

项目简介

主要功能点

安装步骤

服务器配置（用于 MCP 客户端）

基本使用方法

信息