Skip to main content
Glama
Sign In
像塑 MCP Plus

像塑 MCP Plus

by Muqian-Sun
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

rank_subjects

Browse and search themed effect and template rankings to retrieve top effects, view counts, and full details for a selected subject.

Instructions

像塑移动版「专题合集」里按主题的榜单，最新的在前：kind=effect 为特效专题榜（近 200 期，如「测一测玩法特效榜 - 11月」「热爆美妆特效榜」「熊出没IP特效榜」「主题创新优胜特效榜」、各期征集活动优质特效），kind=template 为模板专题榜（如「歌词玩法模板榜」「AI配文创意模板榜」「氛围转场模板榜」）。每个榜带前几个特效、浏览量。keyword 按榜名搜索全部期；传 subject_id 时返回该榜的全部特效（最多 20 个）。

返回里的图片、视频、音频给的是短引用（*_ref / *_refs，如 img:12、video:3），交给 image_view：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。

Input Schema

NameRequiredDescriptionDefault
kindNoeffect 特效专题榜（默认），template 模板专题榜。
countNo每页数量，默认 20（最大 20）。
cursorNo翻页游标，取上一页的 next_cursor。
keywordNo按榜名搜索，如「美妆」「测一测」「IP」；给定时返回全部匹配的期，不分页。
subject_idNo只看这个榜（rank_subjects 返回的 subject_id）。
instance_idNo官方 list_instances 返回的 instance_id，与 project_path 二选一。
project_pathNo目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

由于没有 annotations，描述承担了全部说明责任。它正确披露了返回内容（前几个特效、浏览量）、keyword 与分页交互，以及重要的引用机制——*_ref/*_refs 短引用仅在本次 MCP 运行期间有效，并交给 image_view。但它从未说明这是安全的只读操作、是否可访问所有工程、或是否需要授权。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

把 kind 用法和返回引用说明前置，总体结构良好；每一段都提供可用信息，没有空话。第一句很长，示例挤在一起，但去掉示例会降低工具准确调用的能力。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

面向一个 7 参数的只读工具——没有 annotations、没有 output schema——描述涵盖了榜单内容、分页行为、keyword 覆盖，以及按会话有效的图片/视频/音频引用处理。它没有列出完整的返回字段或明确说明 next_cursor，尽管 schema 已说明 cursor 的用法。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage 为 100%，因此基线是 3；描述在此基础上增加了值，因为它说明了每个 kind 值实际包含什么（示例榜单名、近 200 期、征集活动优质特效），以及 subject_id 是从本工具自身返回中获取的链式输入——这些是 schema 未说明的信息。它没有新增 cursor 或 instance_id 与 project_path 相互替代的语义。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述清楚说明了具体资源（像塑移动版「专题合集」榜单），并用具体的榜单名示例区分 kind=effect（特效专题榜）与 kind=template（模板专题榜）。它允许 agent 在无需打开 schema 的情况下选择正确的 kind，但没有说明与兄弟工具 rank_hotspots、rank_list 或 rank_innovation 的区别。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述给出了清晰的使用上下文：keyword 按榜名搜索全部期且不分页，subject_id 返回该榜全部特效（最多 20 个），这等于说明了先列出、再用 subject_id 下钻的流程。缺少的行为是显式排除——它没有说明何时应改用 rank_hotspots 或 rank_innovation。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools