SEOforGPT MCP Server

SEOforGPT MCP 服务器

用于SEOforGPT的远程MCP服务器，使用Node.js、TypeScript构建， @modelcontextprotocol/sdk，以及Cloudflare Workers使用 streamable-http 运输。

特性

• list_projects：列出已配置API密钥的所有SEOforGPT项目
• check_brand_visibility：在3到5个提示中为品牌运行自定义AI可见性检查
• run_project_analysis：为现有SEOforGPT项目运行已保存的提示
• get_visibility_report：获取以前生成的完整报告

快速启动

SEOFORGPT_API_KEY=sgpt_xxx

安装依赖项并构建：

npm install
npm run build

使用Cloudflare Workers在本地运行：

npm run dev

当您的Cloudflare凭据可用时进行部署：

npm run deploy

配置

服务器需要一个环境变量：

• SEOFORGPT_API_KEY：您的SEOforGPT API密钥，作为发送到上游API Authorization: Bearer

对于本地或部署的Worker环境，您可以在 wrangler.toml，通过 wrangler secret put SEOFORGPT_API_KEY，或通过您的部署环境。

端点

• GET /：基本服务器元数据
• GET /health：健康检查
• POST /mcp：MCP可流式传输HTTP端点

Claude桌面配置

{
  "mcpServers": {
    "seoforgpt": {
      "command": "npx",
      "args": ["-y", "seoforgpt-mcp"],
      "env": { "SEOFORGPT_API_KEY": "sgpt_your_key_here" }
    }
  }
}

Smithery URL

https://seoforgpt-mcp.workers.dev

工具使用示例

1.列出项目

{
  "name": "list_projects",
  "arguments": {}
}

2.检查品牌知名度

{
  "name": "check_brand_visibility",
  "arguments": {
    "brand": "Acme",
    "queries": [
      "Best CRM for small businesses",
      "Top alternatives to HubSpot for startups",
      "Which sales tools are best for B2B teams"
    ]
  }
}

3.运行已保存的项目分析

{
  "name": "run_project_analysis",
  "arguments": {
    "projectId": "proj_123"
  }
}

4.获取一份报告

{
  "name": "get_visibility_report",
  "arguments": {
    "reportId": "report_123"
  }
}

开发说明

• 该实现是无状态的，并为每个请求创建一个新的MCP服务器，非常适合Cloudflare Workers。
• 所有工具故障均归一化为 { "error": "...", "details": "..." } 因此Worker不会在上游API故障时崩溃。
• 服务器使用 process.env.SEOFORGPT_API_KEY 带着一个 env 绑定回退以实现Worker兼容性。