Skip to main content
Glama
sunjianbo-123

svg-annotate-mcp

by sunjianbo-123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_TOOL_TIMEOUTNoTimeout in milliseconds for MCP tools. Optional; setting it lets wait_for_annotations block longer without frequent looping.600000
SVG_ANNOTATE_NO_OPENNoSet to '1' to make the open_svg tool not automatically open a browser (useful for testing).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
open_svgA

在浏览器中打开一个 SVG 图,供用户圈选区域写批注。

打开后应调用 wait_for_annotations 等待用户提交批注。
svg_path 必须是绝对路径。source_script 可选:该 SVG 的生成脚本路径
(如 matplotlib 的 fig_*.py);之后每批批注都会原样带回该路径,
便于判断是改 SVG 文件还是改脚本重跑。title 可选,显示在页面顶栏。
wait_for_annotationsA

阻塞等待用户在浏览器里提交批注,提交后立即返回批注内容。

重要协议:返回 status="timeout" 表示用户还没提交,这不是错误——
若仍在等待用户批注,应立即再次调用本工具继续等待,直到拿到
status="submitted" 或用户在对话里明确说不批注了。
返回的每条批注含:kind(rect/arrow/freehand/text)、note(用户文字)、
geometry_svg(viewBox 坐标)、hits(命中的 SVG 元素:id/文字/祖先链,
用于在 SVG 源文件或生成脚本中定位)、texts_in_region(选区内的文字)。
get_annotationsA

非阻塞地取最近一批已提交的批注(wait_for_annotations 的兜底)。

用于超时链中断后恢复现场;没有批注时返回 status="empty"。
set_statusA

向批注页面顶栏推送一条状态文字,如「正在修改 fig_xxx.py 并重跑…」。

修改开始前调用一次,能让用户知道 Claude 正在干活;改完文件后
页面会因文件变化自动刷新,无需再调用本工具通知。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.1/5.0

Scored across 4 tools

Disambiguation5/5

每个工具职责清晰唯一：打开、等待、获取、状态推送，互不重叠，边界明确。open_svg 负责启动，wait_for_annotations 阻塞等待，get_annotations 非阻塞兜底，set_status 用于反馈，无混淆可能。

Naming Consistency5/5

所有工具均采用 snake_case 的动词_名词结构（open_svg, wait_for_annotations, get_annotations, set_status），动词清晰且规律一致，无混用风格。

Tool Count5/5

4 个工具覆盖了 SVG 批注交互的完整核心流程，每个工具都有不可替代的作用，没有冗余或缺失，数量恰到好处。

Completeness5/5

工具集覆盖了打开、等待提交、非阻塞获取和状态通知，生命周期闭环。没有明显的缺失操作，且描述了超时续等和兜底恢复机制，足以支持用户与 agent 的完整交互。

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources