Rampify MCP服务器

此npm包已弃用。 使用托管的远程服务器——零安装，始终保持最新，更多的工具。 安装指南→

迁移到远程服务器

Rampify MCP服务器现在远程运行在 https://www.rampify.dev/api/mcp。没有要安装的软件包。

克劳德代码：

claude mcp add --transport http rampify \
  https://www.rampify.dev/api/mcp \
  --header "Authorization: Bearer sk_live_your_api_key_here"

光标/VS代码 (.cursor/mcp.json 或 .vscode/mcp.json):

{
  "mcpServers": {
    "rampify": {
      "type": "http",
      "url": "https://www.rampify.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_api_key_here"
      }
    }
  }
}

克劳德·韦伯： 首选 claude.ai → 定制→ 连接器→ 添加带有URL的自定义连接器 https://www.rampify.dev/api/mcp

获取API密钥： rampify.dev/settings/api-keys.

______________________________________________________________________

为什么选择远程服务器？

24工具 与此npm包中的6相比
始终保持最新 --无版本管理
零安装 -只需一个URL和您的API密钥
多项目支持 通过 X-Rampify-Project 头球

此软件包仍可供现有用户使用，但不会收到新版本。

______________________________________________________________________

以前的README

![Website](https://www.rampify.dev) ![Documentation](https://www.rampify.dev/docs/integrations/mcp-server) ![License](LICENSE)

什么是Claude SEO检查器？

A. 克劳德SEO检查器 是一个MCP（模型上下文协议）服务器，为Claude Code和Cursor添加了SEO验证功能。不像 AI排名跟踪器 Rampify会检查您的网站是否出现在Claude的人工智能响应中，并分析您的 网站技术SEO，验证元标记，检测问题，并提供可操作的修复建议——所有这些都可以从您的终端或IDE中完成。

不是AI排名跟踪器。 这是一个开发工具，将SEO智能带入您的编码工作流程。

克劳德SEO检查器vs AI排名跟踪器

功能	克劳德SEO检查器（Rampify）	AI排名跟踪器
它检查什么	您网站的SEO（元标签、模式、性能）	如果您的网站出现在Claude AI的响应中
用例	部署前修复SEO问题	跟踪AI可见性
它在哪里工作	您的IDE（Claude代码、游标）	单独的仪表板
目标受众	开发人员构建网站	营销人员跟踪AI排名
数据源	您的网站+谷歌搜索控制台	Claude AI的回应

关键词： claude seo检查器，mcp-seo服务器，用于claude代码的seo工具，游标seo工具

将谷歌搜索控制台数据、搜索引擎优化见解和人工智能推荐直接带入您的编辑器。没有上下文切换，没有延迟。

______________________________________________________________________

为什么是Rampify？

实时SEO智能 在编辑器中（游标、克劳德代码）
谷歌搜索控制台集成 -查看点击、展示、排名
内容战略见解 -根据真实搜索数据发现下一步要写什么
基于人工智能的推荐 -使用一个命令修复问题
部署前检查 -在上线前发现SEO问题
零上下文切换 -留在你的工作流程中

了解更多→

安装

先决条件

Node.js 18或更高版本
Rampify帐户（免费开始）

通过npm安装

npm install -g @rampify/mcp-server

全球安装使 rampify-mcp 命令在系统范围内可用。

用法

获取API密钥

在配置MCP服务器之前，请获取您的API密钥：

注册Rampify （免费开始）
去你的 Rampify仪表板
导航至 设置→ API密钥
点击 “生成新密钥”
复制密钥（以开头 sk_live_...)
在下面的配置中使用它

项目快速设置（Claude CLI）

推荐： 为每个项目配置MCP服务器，以便每个项目都知道其域：

cd /path/to/your/project
claude mcp add -s local -t stdio \
  --env BACKEND_API_URL=https://www.rampify.dev \
  --env API_KEY=sk_live_your_api_key_here \
  --env SEO_CLIENT_DOMAIN=your-domain.com \
  rampify -- npx -y @rampify/mcp-server

# Reload your IDE window

现在您可以使用MCP工具 不指定域:

get_page_seo -自动使用项目的域
get_issues -自动使用项目的域
crawl_site -自动使用项目的域

全局设置（Claude CLI）

对于所有项目的全局访问（必须在每个请求中指定域）：

claude mcp add --scope user rampify npx \
  -y @rampify/mcp-server \
  --env BACKEND_API_URL=https://www.rampify.dev \
  --env API_KEY=sk_live_your_api_key_here

# Reload your IDE window

手动配置（光标）

添加到光标设置UI或 ~/.cursor/config.json:

{
  "mcpServers": {
    "rampify": {
      "command": "npx",
      "args": [
        "-y",
        "@rampify/mcp-server"
      ],
      "env": {
        // Always use production API
        "BACKEND_API_URL": "https://www.rampify.dev",

        // Get your API key from https://www.rampify.dev/settings/api-keys
        "API_KEY": "sk_live_your_api_key_here",

        // Optional: Set default domain for this project
        "SEO_CLIENT_DOMAIN": "your-domain.com"
      }
    }
  }
}

手动配置（克劳德代码）

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "rampify": {
      "command": "npx",
      "args": [
        "-y",
        "@rampify/mcp-server"
      ],
      "env": {
        // Always use production API
        "BACKEND_API_URL": "https://www.rampify.dev",

        // Get your API key from https://www.rampify.dev/settings/api-keys
        "API_KEY": "sk_live_your_api_key_here",

        // Optional: Set default domain for this project
        "SEO_CLIENT_DOMAIN": "your-domain.com"
      }
    }
  }
}

______________________________________________________________________

配置选项

环境变量

BACKEND_API_URL （必需）：Rampify API端点-始终使用 https://www.rampify.dev
API_KEY （必需）：Rampify仪表板中的API密钥（以 sk_live_...)
SEO_CLIENT_DOMAIN （可选）：此项目的默认域（例如。， yoursite.com)
CACHE_TTL （可选）：缓存持续时间（秒）（默认值：3600）
LOG_LEVEL （可选）： debug, info, warn，或 error （默认值： info)

如何使用工具

发现可用工具

直接问克劳德：

"What SEO tools are available?"
"What can you do for SEO?"
"List all SEO intelligence tools"

Claude将向您展示所有可用的工具及其说明。

自然语言与直接通话

推荐：使用自然语言 （克劳德会选择合适的工具）

"What SEO issues does my site have?" → Calls get_issues
"Check this page's SEO" → Calls get_page_seo
"Crawl my site" → Calls crawl_site

替代方案：直接调用工具 （如果你知道确切的名字）

get_issues({ domain: "example.com" })
get_page_seo({ domain: "example.com", url_path: "/blog/post" })
crawl_site({ domain: "example.com" })

常见工作流

部署后：

1. "Crawl my site" (refresh data)
2. "Show me the issues" (review problems)
3. "Check this page's SEO" (verify specific pages)

部署前：

1. "Check SEO of localhost:3000/new-page" (test locally)
2. Fix issues in editor
3. "Re-check SEO" (verify fixes)
4. Deploy when clean!

定期监测：

1. "What's my site's health score?"
2. "Show critical issues only"
3. Fix high-priority items
4. "Crawl my site" (refresh)

内容规划：

1. "What should I write next?" (get GSC insights)
2. Review top performing pages and queries
3. Check query opportunities (CTR, rankings, gaps)
4. Create content targeting recommended topics

______________________________________________________________________

可用工具

快速参考

工具	目的	何时使用
`get_page_seo`	获取特定页面的SEO数据	分析单个页面，检查性能
`get_issues`	使用健康评分获取所有SEO问题	全站审计，发现问题
`get_gsc_insights`	获取GSC绩效数据和内容建议	发现下一步要写什么，寻找排名机会
`generate_meta`	生成优化的元标签	解决标题/描述问题，提高点击率
`generate_schema`	自动生成结构化数据	将schema.org JSON-LD添加到页面
`crawl_site`	触发新爬网	部署后，刷新数据

______________________________________________________________________

1. `get_page_seo`

获取特定页面的全面SEO数据和见解。 适用于生产站点和本地开发服务器！

参数：

domain （可选）：站点域（例如，“example.com”或“localhost:3000”）。用途 SEO_CLIENT_DOMAIN env-var（如果未提供）。
url_path （可选）：页面URL路径（例如，“/blog/post”）
file_path （可选）：本地文件路径（将解析为URL）
content （可选）：当前文件内容

示例：

生产地点：

Ask Claude: "What's the SEO status of this page?" (while editing a file)
# Uses SEO_CLIENT_DOMAIN from env var

Or explicitly:
get_page_seo({ domain: "example.com", url_path: "/blog/post" })

本地开发服务器：

Ask Claude: "Audit the local version of this page"
get_page_seo({ domain: "localhost:3000", url_path: "/blog/new-post" })

# Or set default to local:
SEO_CLIENT_DOMAIN=localhost:3000

# Now all queries default to local dev server

答复包括：

源指示器: production_database, local_dev_server，或 direct_content
从：分析的确切URL
绩效指标（点击、展示、位置、点击率）- *仅用于生产*
此页面的热门关键字排名- *仅用于生产*
检测到SEO问题并修复- *适用于本地和生产*
速赢机会
AI总结和建议

本地开发工作流程

部署前的测试页面：

启动您的开发服务器：

   npm run dev  # Usually runs on localhost:3000

查询本地页面：

   Ask Claude: "Check SEO of localhost:3000/blog/draft-post"

修复编辑器中的问题，然后重新检查：

   Ask Claude: "Re-check SEO for this page on localhost"

清洁后部署！

本地分析的内容：

标题标签
元说明
标题结构（H1、H2、H3）
图像和alt文本
Schema.org结构化数据
内部/外部链接
搜索性能（不适用于本地-GSC数据仅适用于生产）

响应格式：

{
  // Indicates data source: local_dev_server, production_database, or direct_content
  "source": "local_dev_server",

  // Exact URL that was analyzed
  "fetched_from": "http://localhost:3000/blog/new-post",

  "url": "http://localhost:3000/blog/new-post",

  // Array of detected issues with severity and recommendations
  "issues": [...],

  // AI-generated summary and recommendations
  "ai_summary": "**Local Development Analysis**..."
}

______________________________________________________________________

2. `get_issues`

使用健康评分获取整个网站的SEO问题。返回所有检测到的问题的综合报告。

参数：

domain （可选）：站点域（使用 SEO_CLIENT_DOMAIN 如果没有提供）
filters （可选）：

- severity：要包括的严重性级别数组(['critical', 'warning', 'info']) - issue_types：特定问题类型数组 - limit：要返回的最大问题数（1-100，默认值：50）

示例：

Ask Claude: "What SEO issues does my site have?"
# Uses SEO_CLIENT_DOMAIN from env var

Ask Claude: "Show me only critical SEO issues"
# AI will filter by severity: critical

Ask Claude: "Check SEO issues for example.com"
get_issues({ domain: "example.com" })

答复包括：

健康评分（0-100）和等级（A-F）
按严重程度（严重、警告、信息）列出的问题摘要
带有修复建议的问题详细列表
按影响排序的建议行动

使用案例：

全站SEO审计
一次发现所有问题
跟踪随时间推移的改进
按严重程度对修复进行优先级排序

______________________________________________________________________

3. `get_gsc_insights` 新

通过人工智能内容推荐获取谷歌搜索控制台性能数据。 根据真实的搜索数据发现下一步要写什么。

参数：

domain （可选）：站点域（使用 SEO_CLIENT_DOMAIN 如果没有提供）
period （可选）：分析时间段- 7d, 28d，或 90d （默认值： 28d)
include_recommendations （可选）：包括基于AI的内容推荐（默认值： true)

示例：

Ask Claude: "What should I write next?"
# Uses SEO_CLIENT_DOMAIN, analyzes 28-day period

Ask Claude: "Show me my top performing pages from last week"
get_gsc_insights({ period: "7d" })

Ask Claude: "What queries am I ranking for?"
get_gsc_insights({ domain: "example.com", period: "28d" })

它提供了什么：

1.性能总结

总点击量、展示次数、平均位置、点击率
比较不同时间段的性能

2.表现最佳的页面

点击量前20页
每个都有性能指标和热门查询
看看哪些内容能引起观众的共鸣

3.查询商机 （自动检测到4种类型）

提高CTR：高展示率（100+）但低点击率（\Your Optimized Title | Brand


**专业提示：**

- 修复内容后运行，以确保元标签匹配
- 测试社交分享 [Facebook共享调试器](https://developers.facebook.com/tools/debug/)
- 在谷歌搜索控制台中监控CTR的改进
- 当页面内容发生重大变化时更新元标签

______________________________________________________________________

## 发展

### 观看模式

npm run watch


这将在每次更改时重新编译TypeScript。

### 本地测试

In one terminal, start your backend

cd /path/to/rampify npm run dev

In another terminal, build and run MCP server

cd packages/mcp-server npm run dev


MCP服务器将连接到您的本地后端 `http://localhost:3000`.

### 调试日志记录

集 `LOG_LEVEL=debug` 在你的 `.env` 文件以查看详细日志：

LOG_LEVEL=debug npm run dev


## 建筑

MCP Server (packages/mcp-server) ├── src/ │ ├── index.ts # MCP server entry point │ ├── config.ts # Configuration loader │ ├── tools/ # MCP tool implementations │ │ ├── get-seo-context.ts │ │ ├── scan-site.ts │ │ └── index.ts # Tool registry │ ├── services/ # Business logic │ │ ├── api-client.ts # Backend API client │ │ ├── cache.ts # Caching layer │ │ └── url-resolver.ts # File path → URL mapping │ ├── utils/ │ │ └── logger.ts # Logging utility │ └── types/ # TypeScript types │ ├── seo.ts │ └── api.ts └── build/ # Compiled JavaScript (generated)


## 缓存

MCP服务器缓存响应1小时（可通过以下方式配置 `CACHE_TTL`)以提高性能。

在以下情况下，缓存会自动清除：

- 条目过期（已达到TTL）
- 服务器重新启动
- 您手动清除（尚未实现）

## 故障排除

### “找不到域的客户端”

**解决方案：** 首先将网站添加到您的仪表板 `http://localhost:3000`

### “后端API连接失败”

**检查表：**

1. 后端是否正在运行？ (`npm run dev` 在根目录中）
1. 是 `BACKEND_API_URL` 正确 `.env`?
1. 检查日志 `LOG_LEVEL=debug`

### “MCP服务器未出现在游标中”

**检查表：**

1. 你建造了服务器吗？ (`npm run build`)
1. Cursor配置中的路径是绝对的吗？
1. 更改配置后重新启动Cursor
1. 检查游标日志（帮助→ 切换开发人员工具→ 控制台）

### 数据为空或缺失

**常见原因：**

- 站点尚未分析（请先在仪表板中运行分析）
- GSC未连接（在仪表板设置中连接）
- 数据库中没有URL（触发站点分析）

### “无法连接到本地开发服务器”

**解决方案：**

1. 确保您的开发服务器正在运行(`npm run dev`)
1. 验证端口（默认值为3000，但您的端口可能不同）
1. 使用带端口的完整域： `localhost:3000` （不只是 `localhost`)
1. 检查开发服务器日志中的CORS或其他错误

**示例错误：**

Could not connect to local dev server at http://localhost:3000/blog/post. Make sure your dev server is running (e.g., npm run dev).


### 地方与生产混乱

**如何判断您正在使用的来源：**

每个响应都包含明确的 `source` 和 `fetched_from` 领域：

{ // Source: local_dev_server, production_database, or direct_content "source": "local_dev_server",

// Exact URL that was fetched and analyzed "fetched_from": "http://localhost:3000/page", // ... rest of response }


**专业提示：** 集 `SEO_CLIENT_DOMAIN` 每个项目，以避免每次都指定域：

- 对于本地开发人员： `SEO_CLIENT_DOMAIN=localhost:3000`
- 生产： `SEO_CLIENT_DOMAIN=yoursite.com`

## 路线图

### 第一阶段：核心工具（完整）

- 完成： `get_page_seo` -获取特定页面的SEO数据
- 完成： `get_issues` -使用健康评分获取所有网站问题
- 完成： `get_gsc_insights` -通过内容建议获取GSC性能数据（新增）
- 完成： `generate_meta` -AI驱动的标题和元描述生成
- 完成： `generate_schema` -自动生成结构化数据（文章、产品等）
- 完成： `crawl_site` -触发新站点爬网

### 第2阶段：工作流程和优化工具（计划中）

- 计划： `suggest_internal_links` -内部链接建议
- 计划： `check_before_deploy` -部署前SEO验证
- 计划： `optimize_blog_post` -博客内容深度优化
- 计划： `optimize_landing_page` -以转化为中心的SEO

### 未来（第4+阶段）

- 跨多个页面的批量操作
- 历史趋势分析
- 竞争监控
- 先进的人工智能见解和建议

## 支持

需要帮助？

- **[文档](https://www.rampify.dev/docs/mcp-server)** -完整的指南和教程
- **** -报告错误或请求功能
- **[Rampify设置](https://www.rampify.dev/settings/api-keys)** -管理您的网站和API密钥

## 了解更多

- **[什么是Rampify？](https://www.rampify.dev/docs/introduction)** -产品概述
- **[MCP服务器指南](https://www.rampify.dev/docs/mcp-server)** -详细文件
- **[博客](https://www.rampify.dev/blog)** -SEO技巧和产品更新

## 许可证

麻省理工学院

Rampify MCP Server

快速接入

详细介绍

Rampify MCP服务器

迁移到远程服务器

为什么选择远程服务器？

以前的README

什么是Claude SEO检查器？

克劳德SEO检查器vs AI排名跟踪器

为什么是Rampify？

安装

先决条件

通过npm安装

用法

获取API密钥

项目快速设置（Claude CLI）

全局设置（Claude CLI）

手动配置（光标）

手动配置（克劳德代码）

配置选项

环境变量

如何使用工具

发现可用工具

自然语言与直接通话

常见工作流

可用工具

快速参考

1. `get_page_seo`

本地开发工作流程

2. `get_issues`

3. `get_gsc_insights` 新

In one terminal, start your backend

In another terminal, build and run MCP server

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

Rampify MCP Server

快速接入

详细介绍

Rampify MCP服务器

迁移到远程服务器

为什么选择远程服务器？

以前的README

什么是Claude SEO检查器？

克劳德SEO检查器vs AI排名跟踪器

为什么是Rampify？

安装

先决条件

通过npm安装

用法

获取API密钥

项目快速设置（Claude CLI）

全局设置（Claude CLI）

手动配置（光标）

手动配置（克劳德代码）

配置选项

环境变量

如何使用工具

发现可用工具

自然语言与直接通话

常见工作流

可用工具

快速参考

1. get_page_seo

本地开发工作流程

2. get_issues

3. get_gsc_insights 新

In one terminal, start your backend

In another terminal, build and run MCP server

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

1. `get_page_seo`

2. `get_issues`

3. `get_gsc_insights` 新