GEO 数据 MCP Server

在 Cursor 中通过自然语言查询品牌可见度、引用、舆情、认知等 GEO 数据。

使用模式

A. 远程托管（推荐，多租户 key）

管理员在后台 「管理后台 → MCP 接口授权」 页面创建 key：勾选可用接口（白名单）、设定授权品牌（可见全部 / 指定品牌）、可选过期时间，生成后得到一次性明文 key，发给使用者。

使用者在 Cursor 的 mcp.json 中配置远程端点（无需本地部署）：

{
  "mcpServers": {
    "geo-data": {
      "url": "https://dashboard.noiseoff.cn/mcp",
      "headers": { "Authorization": "Bearer <你的 MCP key>" }
    }
  }
}

特性：

• 工具列表按 key 白名单动态显示 —— 对方只看得到被授权的工具；
• 品牌级隔离 —— 非全品牌 key 查询其他品牌数据会被拒绝；
• 写/触发类（高危）工具 需 key 角色为 operator 及以上；
• 即时撤销 —— 后台停用/删除 key，对方下次调用立即失效。

服务端需配置 GEO_API_URL（指向本服务自身，供网关工具回调）与 GEO_API_KEY（= 后台 .env 的 MCP_API_KEY，内部全权）。

B. 本地 stdio（单机 / 调试）

快速开始

方式 1：项目内使用（已配置）

本工作区的 .cursor/mcp.json 已配置好 MCP Server，Cursor 会自动识别并启动。

方式 2：其他项目中使用

在 ~/.cursor/mcp.json（全局）或项目的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "geo-data": {
      "command": "node",
      "args": ["/path/to/geo-admin-server/mcp/index.js"],
      "env": {
        "GEO_API_URL": "https://dashboard.noiseoff.cn",
        "GEO_API_KEY": "your-api-key"
      }
    }
  }
}

方式 3：npx 运行（发布 npm 后）

{
  "mcpServers": {
    "geo-data": {
      "command": "npx",
      "args": ["-y", "geo-data-mcp-server"],
      "env": {
        "GEO_API_URL": "https://dashboard.noiseoff.cn",
        "GEO_API_KEY": "your-api-key"
      }
    }
  }
}

环境变量

| 变量 | 说明 | |------|------| | GEO_API_URL | 后台服务器地址 | | GEO_API_KEY | API Key（后台 .env 中的 MCP_API_KEY） |

能力边界

MCP Server 只调用 GEO_API_URL 指向的远程 HTTP API，不执行用户本地脚本，不读写用户本地报告目录，也不依赖本地浏览器登录态。

截图、日报、周报等能力需要先由服务器提供正式 API。当前 MCP 不暴露本地脚本型截图或报告生成命令。

可用工具（42 个）

品牌基础

• list_companies — 列出所有品牌及其 ID、别名、行业
• get_company_detail — 获取品牌完整配置详情（别名、行业、平台、产品等）
• get_brand_snapshot — 获取品牌某日全量快照
• upsert_company — 创建或更新品牌/公司记录
• get_snapshot_trend — 获取品牌多日快照趋势

可见度

• get_visibility_ranking — 行业可见度排名
• get_category_visibility — 品类可见度
• get_pet_category_visibility — 宠物品类可见度

引用分析

• get_citation_leaderboard — 引用来源排行榜
• get_article_leaderboard — 被引文章排行榜
• get_citation_records — 引用记录明细

品牌洞察

• get_brand_perception — 品牌认知（词云、评分）
• get_brand_sentiment — 品牌舆情（评分、正负面）
• generate_brand_perception — 远程触发生成品牌认知数据
• generate_brand_sentiment — 远程触发生成品牌舆情数据
• generate_brand_stats — 远程触发生成品牌可见度统计快照

GEO 监控

• get_source_trend — 引用来源趋势
• get_dashboard_data — 监控看板聚合数据
• get_prompt_list — 提示词列表
• get_prompt_records — 分页获取完整 AI 回复记录（报告复算用）
• get_app_prompt_records — 获取 App 平台 AI 回复记录（默认 DeepSeek App + 豆包 App，无需手动传 site）
• get_app_web_prompt_records — 按品牌拉取 App 端 vs 网页端监测记录（默认 DeepSeek/豆包网页端与 App 端，支持平台 × 日期对比）
• create_prompt_list — 创建新的提示词列表

知识库

• search_knowledge_base — 语义检索
• get_platform_content_features — 平台内容特征

行业配置

• get_industry_brand_dictionary — 竞品品牌词典
• refresh_industry_brand_dictionary — 远程刷新指定行业竞品词典
• backfill_industry_brand_dictionaries — 远程回填行业竞品词典

运行实例

• create_prompt_list_pod — 远程创建绑定提示词列表的运行 Pod；默认可见度跑 3 轮、舆情跑 1 轮
• get_container_progress — 批量获取 Pod/Job 的执行进度

场景分析（提示词场景 / 实时）

• get_prompt_facets — 提示词分面配置（可分析维度）
• get_prompt_scenes — 提示词场景列表（场景级可见度）
• get_prompt_scene_detail — 单场景明细（提及/引用/提示词）
• get_brand_live — 品牌实时数据（非定格快照）

GEO 监控（补充）

• get_source_leaderboard — 引用来源排行榜（geo-monitoring 口径）
• get_source_records — 来源域名明细记录
• get_preference_summary — 平台偏好汇总

平台偏好（补充）

• get_platform_overview — 平台偏好概览
• get_response_style — 各 AI 平台回复风格分析
• get_top_cited_urls — 高引 URL 排行

行业级

• get_industry_monitoring_overview — 行业级监控概览

词云溯源

• get_perception_chunks — 按 chunk/sourceUid 批量取原始片段（认知/舆情溯源）

暂不暴露的能力

以下能力目前仍依赖本地脚本或文件系统，因此不作为 MCP 工具提供：

• 品牌动态仪表盘截图
• 日报 Markdown 生成
• 周报 HTML 生成
• 本地报告/截图产物列表
• 完整品牌统计快照脚本编排

如需通过 MCP 支持这些能力，应先在服务器新增正式 API，例如：

• POST /api/reports/daily
• POST /api/reports/weekly
• POST /api/screenshots/brand-dashboard
• GET /api/jobs/:jobId
• GET /api/artifacts/:artifactId

使用示例

在 Cursor 中直接对 AI 说：

• "查一下皇家 4 月 10 日的可见度排名"
• "获取皇家上周的快照趋势数据"
• "看看皇家的引用来源排行榜"
• "获取皇家最新的舆情数据"
• "生成皇家 5 月 10 日的品牌认知数据"（调用 generate_brand_perception）
• "生成皇家 5 月 10 日的舆情数据"（调用 generate_brand_sentiment）
• "刷新宠物食品行业的竞品词典"（调用 refresh_industry_brand_dictionary）

开发

cd geo-admin-server/mcp
npm install

# 测试启动
GEO_API_URL=http://localhost:3001 GEO_API_KEY=test node index.js