项目简介

Ahrefs MCP Server是一个实现了Model Context Protocol (MCP) 的应用后端，旨在允许支持MCP的LLM客户端（如Claude桌面版、Cursor等）通过JSON-RPC协议访问Ahrefs的SEO数据和工具。它充当LLM客户端和Ahrefs API之间的桥梁，将LLM发出的工具调用请求转换为对Ahrefs API的实际HTTP请求，并将API响应格式化后返回给LLM。

主要功能点

工具集成: 暴露Ahrefs API提供的多种SEO工具，涵盖关键词研究、网站分析、反向链接检查、网站审计等核心功能。
数据访问: 允许LLM通过调用相应的工具获取Ahrefs平台的各类SEO数据，如关键词排名、网站流量、外部链接概况等。
上下文提供: 作为LLM的外部上下文提供者，使LLM能够利用实时或最新的SEO数据来辅助回答用户关于SEO的查询或执行相关任务。
标准化交互: 通过遵循MCP协议，确保与兼容的LLM客户端进行标准化的通信。
需要API Key: 访问Ahrefs数据需要有效的Ahrefs API Key进行认证。

安装步骤

确保您已安装Node.js和npm。您可以从nodejs.org下载并安装。安装完成后，通过运行 'npm -v' 验证安装是否成功。
在终端中运行以下命令全局安装Ahrefs MCP Server：
```
npm install @ahrefs/mcp -g
```
如需升级，再次运行此命令即可。

服务器配置（为您的LLM客户端配置）

MCP服务器通常作为本地进程启动，并由LLM客户端进行管理和通信。您需要在您的LLM客户端的配置文件中添加Ahrefs MCP Server的配置信息。配置格式为JSON，大致如下（具体路径和结构请参考您的LLM客户端文档）：

在您客户端的MCP配置 JSON 文件中，找到或创建 '"mcpServers"' 部分，然后添加一个名为 '"ahrefs"' 的对象：

{
    "mcpServers": {
        "ahrefs": {
            "command": "npx",
            "args": [
                "@ahrefs/mcp"
            ],
            "env": {
                "API_KEY": "YOUR_AHREFS_API_KEY" // 在此处替换为您的Ahrefs API密钥
            }
        }
    }
}

'"ahrefs"': 这是您为该MCP服务器定义的唯一名称。
'"command"': 启动服务器进程的命令，通常设置为 '"npx"'。
'"args"': 传递给启动命令的参数数组，这里是 MCP 包的名称 '@ahrefs/mcp'。
'"env"': 传递给服务器进程的环境变量。'"API_KEY"' 必须设置为您的Ahrefs API密钥，这是服务器连接Ahrefs API所必需的。请参考Ahrefs官方文档了解如何创建或管理API密钥。

配置文件的位置取决于您使用的LLM客户端：

Claude Desktop:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\Claude_desktop_config.json'
- 首次使用可能需要按照官方文档创建文件。
Cursor:
- 项目特定: '.cursor/mcp.json' (在项目根目录)
- 全局: '~/.cursor/mcp.json'

请将上述配置内容添加到您相应客户端的MCP配置文件中，并将 '"YOUR_AHREFS_API_KEY"' 替换为您的实际Ahrefs API密钥。

基本使用方法

配置完成后，重新启动您的LLM客户端。客户端会自动发现并连接Ahrefs MCP Server。当您向LLM提出需要Ahrefs数据的请求时（例如，“请分析ahrefs.com的外部链接”），LLM会识别出需要调用Ahrefs MCP Server提供的工具，并向服务器发送相应的JSON-RPC请求。服务器接收请求，使用您的API Key调用Ahrefs API，获取数据，并将结果返回给LLM。LLM会利用这些数据来回答您的查询或执行任务。

您可以通过向LLM提问，让其展示可用工具列表，或者调用服务器提供的 'doc' 工具（例如，询问LLM“使用ahrefs的doc工具查看rank-tracker-overview的文档”）来了解具体工具的功能和参数。

关键词

信息