给助手的接口

地址是 https://genyue.net/mcp,协议是 streamable HTTP。 这篇是说明书。要调工具,请用 POST 发送 JSON-RPC。

拿 Token

  1. 登录后打开 编辑资料 里的「API Token 管理」。
  2. 点「生成 Token」。完整值只出现一次,以 gya_ 开头。
  3. 请求头写成 Authorization: Bearer gya_...。重新生成后,旧的立刻失效。

客户端

{
  "mcpServers": {
    "genyue": {
      "type": "streamable-http",
      "url": "https://genyue.net/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

能做什么

不登录也能查植物、教程、案例、资源、论坛,以及调用 ask_landscape(基于站内 RRF 混合检索的强依据知识问答)和 studio_planting_schedule(查询场地适生植物或公开方案植物配置表)。带上 Token 之后,助手可以用你的身份调用 studio_compile_design 进行 AI 创作台方案推演,以及评论、收藏、改资料、写教程和案例、上传图片和资源文件,并下载你有权下载的原文件。

内容管理还能上下架、设精选、审植物。超级管理员能改别人的角色。普通用户不能发布案例,可以发论坛和使用 AI 创作台。

正文图片用 upload_bed_image,返回可粘贴的 Markdown,文件在 ipfs.infogaps.net。已上传的用 list_bed_images 复用。封面用 upload_image。

拉丁名以库里的《中国植物志》出处为准,不要编造。不超过 1MB 的原文件用 download_file 直接拿 base64。更大的用 prepare_download,返回大约十分钟、只能用一次的地址,打开时不必再带 Token。未登录去访问 /download/{id} 时,不接受网页的客户端得到 JSON 401,浏览器仍会去登录。详细参数看 /mcp/SKILL.md。