Novence

Novence MCP

面向 Novence 的托管 Model Context Protocol 服务——为 AI Agent 提供静态网站托管。

你的 Agent 可以构建网站。然后，几秒钟内就能为它提供发布去处。

_{20 秒 · Claude Code、Cursor、Codex 或任何其他 Agent · 从插件到可访问的网址}

• 端点： https://api.novence.ai/mcp（可流式传输的 HTTP）
• 身份验证： 初始使用时可选。调用 bootstrap(email)；会话会采用 nv_ 密钥。后续会话使用 Authorization: Bearer nv_…。
• 文档： novence.ai/mcp
• 隐私： novence.ai/privacy

此仓库是 Claude Code 插件 / 安装包（Novence-ai/mcp）。MCP 服务本身托管于远程，无需在本地运行任何内容。

Dockerfile 和 catalog/ stdio 适配器仅供 MCP 目录（Glama）使用。它们通过 tools/list 返回公开的工具架构，不包含托管 API。终端用户应使用 https://api.novence.ai/mcp。

根目录的 .mcp.json（以及供 Cursor / Agent Plugins 使用的 mcp.json）兼容 Cursor：仅包含 URL，不含 Claude ${user_config.*} 占位符。完成 bootstrap 后，Cursor / shell 客户端会通过环境变量 NOVENCE_API_KEY 和 Bearer 标头持久保存身份验证信息。Claude Code 插件通过 .claude-plugin/plugin.json 内嵌的 mcpServers 保留 Keychain / userConfig.api_key。

供注册中心使用的 Skill：skills/novence-deploy（可用后运行 gh skill install Novence-ai/mcp novence-deploy）。

安装（Claude Code）

claude plugin marketplace add Novence-ai/mcp
# or: enable from the Claude plugin directory after listing is approved

Novence API key 留空。调用 bootstrap(email)（MCP）。获得可访问的网址后，将 nv_ 密钥粘贴到插件设置（Keychain）中，并运行 /reload-plugins，以便后续会话保持已验证状态。

Claude 通过插件的 userConfig 存储密钥。空插值会被视为未经身份验证（Bearer / 未插值的 ${user_config.api_key}），因此在填写该字段之前，bootstrap 也能正常工作。

Cursor / shell

根目录的 .mcp.json 符合这种仅含 URL 的格式（不含身份验证标头）。不带标头连接，然后运行 bootstrap：

{
  "mcpServers": {
    "novence": {
      "url": "https://api.novence.ai/mcp"
    }
  }
}

完成 bootstrap 后，持久保存密钥：

export NOVENCE_API_KEY='nv_…'

{
  "mcpServers": {
    "novence": {
      "url": "https://api.novence.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NOVENCE_API_KEY}"
      }
    }
  }
}

一键安装（无需密钥）：添加到 Cursor

通用 MCP 客户端

与 Cursor 相同：先仅使用 URL，然后在 bootstrap 后添加 Authorization: Bearer nv_…。

如果你不使用 MCP，可使用 REST 备用方案：

# Deploy first (no email): curl -sS -X POST https://api.novence.ai/v1/demo
curl -sS -X POST https://api.novence.ai/v1/bootstrap \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

获得可访问的网址后，验证通过邮件发送的 OTP，即可解锁完整的 Free 配额。

工具

工具	描述
bootstrap / verify_email / resend_verification / reissue_key	无需预先提供 nv_ 密钥即可注册；获取实时 URL 后进行 OTP 验证
create_project / list_projects / get_project / update_project_settings	项目生命周期（仅限 *.novence.ai 上的 share_gate_emails OTP；Pro/Scale 套餐支持 site_mcp 访客 MCP；Pro/Scale 套餐支持所有者通过 /edit 使用 data_edit_emails + data_edit_names）
get_upload_url / get_upload_urls_batch / confirm_upload / confirm_uploads_batch	上传网站文件
list_files / get_file / delete_file	管理项目文件
set_redirects	暂存 /_redirects（SPA：/* /index.html 200）；调用 deploy 以应用
put_site_data	无需部署即可更新线上 /data/{name}.json（Pro/Scale 套餐）
get_site_brief / put_site_brief / list_site_events	私有站长简报 + 收件箱（Pro/Scale 套餐）。会话开始时：先获取，再列出。
deploy / get_deployment_status / get_preview_url / rollback	发布、轮询、预览别名（Pro/Scale 套餐）、回滚最近 5 次部署
publish_html	一个 HTML 文档 → index.html + 部署（省略 project_id 即可创建项目）
run_checks / get_checks_results	质量检查（Lighthouse、无障碍、链接）
configure_custom_domain / get_domain_status	自定义域名（CNAME www → fallback.novence.ai；apex ALIAS 或 URL 重定向）
create_form / list_forms / update_form / list_form_submissions / delete_form_submission	表单
checkout / mpp_upgrade / billing_portal	付费套餐（已验证邮箱；创建第 2 个项目后或遇到 402 错误时）
get_quotas_and_usage / get_project_usage / update_project_settings (analytics_enabled) / get_project_analytics / get_account	配额、用量和自愿启用的网站流量分析
create_account_session / get_account_console_kit	账单/账户控制台工具包（切勿将 nv_ 嵌入 HTML）

官方注册表

以 ai.novence/mcp 的名称发布于 registry.modelcontextprotocol.io。

许可证

MIT — 详见 LICENSE。