跳到主要内容

MCP 服务器

Ideon 已发布一方维护的 Model Context Protocol 服务器（stdio 传输）。

当前状态​

  • 入口命令：ideon mcp serve
  • 传输：stdio
  • 目标场景：本地进程拉起的 MCP 客户端
  • 当前工具集：
    • ideon_write
    • ideon_write_resume
    • ideon_delete
    • ideon_links
    • ideon_config_get
    • ideon_config_set
    • ideon_config_list
    • ideon_config_unset
    • gkp_generate_ideas
    • gkp_get_historical_data
    • gkp_get_forecast_data
    • ideon_preview
    • ideon_author_add、ideon_author_list、ideon_author_edit、ideon_author_remove
    • （以及出版物、系列、队列、规划、导出等工具 — 完整列表见英文版 MCP Servers）

SEO 检查作为流水线第 4 阶段在 ideon_write / ideon_write_resume 中运行——没有独立的 SEO MCP 工具。ideon_write 可选参数：author（作者 slug）、experienceNotes（运行轶事）、noSeoCheck、seoCheckMode（errors-only | strict）、seoCheckMaxTurns（1–20）；ideon_write_resume 可选参数：seoCheck（强制重跑）、seoCheckMode、seoCheckMaxTurns。结果写入 meta.json（seoCheck、author、editorialChecklist）。成功运行后工具响应包含编辑清单摘要。

预览​

  • ideon_preview — 启动、停止或查询本地预览服务器状态
参数类型必填默认值说明
action枚举是—start、stop 或 status
port整数否4173预览服务器端口（仅 start）。在 Telepat Monad 中，经 Caddy 后传入 5679。
markdownPath字符串否最新生成的 markdown要预览的 markdown 文件（仅 start）

structuredContent.url 始终为 http://localhost:<port>。反向代理后的运行环境应转换为公开 URL（如 Monad 中的 TELEPAT_IDEON_PREVIEW_URL）。

状态仅反映当前 MCP 进程启动的预览服务器。通过 ideon preview 单独启动的服务器不会被跟踪。

  • gads_login — 启动 Google Ads API OAuth 流程。尽可能保存静态凭据；在 structuredContent 中返回 authUrl 和 port。
  • gads_login_status — 轮询 OAuth 状态：not_started、pending、completed 或 timed_out。completed 时返回 refreshToken、saved 和 envVarName（TELEPAT_GOOGLE_ADS_REFRESH_TOKEN）。
  • gads_test — 通过测试 API 调用验证已配置的凭据。
  • gads_logout — 清除 Google Ads 凭据（all 清除全部）。

容器持久化约定（TELEPAT_DISABLE_KEYTAR=1）：

  • 静态凭据应通过 TELEPAT_GOOGLE_ADS_* 环境变量预先设置。
  • 已在 env 中的凭据，gads_login 会跳过钥匙串 configSet。
  • OAuth 完成时，saved: false 并返回 refreshToken，供外部持久化（如代理写入 .env）。

将 TELEPAT_IDEON_GADS_REDIRECT_URL 设为公开回调 URL（Web OAuth）。回退：http://localhost:9876/callback（桌面 OAuth）。

Google 关键词规划师工具​

三个 gkp_* 工具提供来自 Google Ads 关键词规划师的真实关键词数据。使用前需要配置六个 Google Ads 凭据。

设置说明请参阅 Google Ads 关键词规划师设置。

契约说明​

  • 工具契约必须与 CLI 行为和 skill 元数据保持同步。
  • 契约一致性通过 lint 中的 integration sync 校验保障。
  • 工具处理器错误会以 MCP 工具错误形式返回可执行信息。

维护策略​

强制同改规则与评审清单见：