Exécutez n'importe quel Skill dans Manus
en un clic

Exécutez n'importe quel Skill dans Manus en un clic

Commencer

mcp-tool-annotations

Étoiles2

Forks0

Mis à jour8 juillet 2026 à 04:02

Apply consistent read-only, idempotent, and destructive hints to MCP tools to improve client safety and UX.

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

tvnkhoa

tvnkhoa/mcp-local

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

SKILL.md

readonly

name	mcp-tool-annotations
description	Apply consistent read-only, idempotent, and destructive hints to MCP tools to improve client safety and UX.

MCP Tool Annotations

When to Use

Add a new tool.
Change tool behavior from read to write, or vice versa.
Review tool semantics before release.

Procedure

Classify operation type
- Read-only: no state mutation.
- Write non-destructive: mutates but safe to retry only when idempotent.
- Destructive: overwrite/delete/high-impact mutation.
Set semantic hints
- readOnlyHint for pure reads.
- idempotentHint for safe retries with same input.
- destructiveHint for high-impact writes.
Verify consistency
- Tool description, schema, and implementation semantics agree.
Document implications
- README notes expected side effects and retry safety.

Output Format

Annotation map per tool
Mismatch list and required fixes

Plus depuis ce dépôt

même dépôt

key

tvnkhoa/mcp-local

"Browse Bitbucket Cloud repositories and pull requests, read PR diffs, and create pull requests via the {{DISPLAY_NAME}}. Triggers on: list repos/branches/PRs, view a pull request or its diff, open/create a PR. PR creation is gated and supports dryRun."

2026-07-082

db-parameterization-audit

tvnkhoa/mcp-local

Audit SQL construction to ensure parameterized execution, anti-concatenation posture, and read-only safety.

2026-07-082

db-query-budgeting

tvnkhoa/mcp-local

Control DB query budget with timeout, row limits, and concurrency caps to prevent abuse and resource exhaustion.

2026-07-082

mcp-contract-conformance

tvnkhoa/mcp-local

Validate MCP contract stability for tools/list, tools/call, schemas, and backward compatibility before merge or release.

2026-07-082

mcp-error-taxonomy

tvnkhoa/mcp-local

Standardize MCP errors into user-actionable vs developer/internal classes with stable codes and safe messages.

2026-07-082

mcp-host-integration-security

tvnkhoa/mcp-local

Harden MCP host/client integration with token hygiene, scope minimization, transport safeguards, and policy checks.

2026-07-082

name	mcp-tool-annotations
description	Apply consistent read-only, idempotent, and destructive hints to MCP tools to improve client safety and UX.

MCP Tool Annotations

When to Use

Add a new tool.
Change tool behavior from read to write, or vice versa.
Review tool semantics before release.

Procedure

Classify operation type
- Read-only: no state mutation.
- Write non-destructive: mutates but safe to retry only when idempotent.
- Destructive: overwrite/delete/high-impact mutation.
Set semantic hints
- readOnlyHint for pure reads.
- idempotentHint for safe retries with same input.
- destructiveHint for high-impact writes.
Verify consistency
- Tool description, schema, and implementation semantics agree.
Document implications
- README notes expected side effects and retry safety.

Output Format

Annotation map per tool
Mismatch list and required fixes