New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

MCP Development

by adeze in adeze/raindrop-mcp

MCP Server Development Patterns and Best Practices. An agent skill from adeze/raindrop-mcp.

MITAuto-check passedAgent Workflows

Install MCP Development

skills CLI
$ npx skills add adeze/raindrop-mcp --skill mcp-development -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adeze/raindrop-mcp mcp-development --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adeze/raindrop-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/mcp-development .claude/skills/mcp-development && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcp-development
GitHub stars
188
Token cost
~855 tokens
SKILL.md length
379 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

MCP Server Development Patterns and Best Practices. An agent skill from adeze/raindrop-mcp.

  • Tasks that involve MCP servers
  • SKILL.md covers MCP Server Design Patterns, Tool Implementation Patterns and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

MCP Development is an agent skill from adeze/raindrop-mcp. MCP Server Development Patterns and Best Practices

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/mcp-development”

What it can do on your machine

Read from SKILL.md and the folder at commit 5b1e7f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • modelcontextprotocol.io
    • vitest.dev
    • developer.raindrop.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP Development loads about 855 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 379 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~855

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from adeze/raindrop-mcp at commit 5b1e7f9, republished under its MIT licence (© adeze). 379 words, ~855 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-development/SKILL.md (or your agent's skills folder).
name
mcp-development
description
MCP Server Development Patterns and Best Practices
keywords
mcp, server, typescript, design-patterns, protocol-compliance

MCP Server Development Skill

Guidelines for designing and implementing MCP servers with TypeScript, focusing on protocol compliance, service architecture, and extensibility.

MCP Server Design Patterns

  • Protocol Compliance: All server logic must strictly follow the Model Context Protocol (MCP) specification. Reference MCP docs and LLMs integration guide.
  • Transport Abstraction: Implement transport-agnostic logic. Use interfaces and dependency injection for HTTP, STDIO, or custom transports.
  • Service Layer: Encapsulate business logic in service classes. Each service should be stateless, testable, and expose clear async methods for protocol operations.
  • Schema Validation: Use zod for all input/output validation. Define schemas for requests, responses, and errors. Validate at the transport boundary.
  • Error Handling: Centralize error handling. Return MCP-compliant error objects with descriptive messages and codes.
  • Manifest & Tooling: Expose a manifest endpoint/tool for host integration. Manifest must declare all supported operations, schemas, and metadata.
  • Extensibility: Design for easy addition of new tools/operations. Use a registry or factory pattern for tool handlers.
  • Testing: Use Vitest for all tests. Place tests in tests/ and cover protocol, service, and transport logic.
  • Logging: Use a configurable logger. Avoid console.log for STDIO servers; use structured logging and log levels.
  • Async/Await: All operations must be async.
  • Type Safety: Use TypeScript interfaces and types for all protocol objects.
  • Configuration: Use environment variables and config files for secrets, endpoints, and options.
  • Documentation: Document all public classes, methods, and schemas.
Show full SKILL.md (156 more words)Show less

Tool Implementation Patterns

  • Tool Registration: Register each tool in a central registry or manifest. Use a factory or mapping to resolve tool handlers by name.
  • Tool Handler Structure: Implement each tool as a class or function with a clear async run or execute method. Accept validated input, return structured output.
  • Schema-Driven: Define input/output schemas with zod. Validate all tool calls at runtime.
  • Error Propagation: Catch errors in tool handlers and return MCP-compliant error objects.
  • Resource Access: For resource tools (e.g., collections, bookmarks), encapsulate resource logic in dedicated service classes. Use dependency injection for external APIs.
  • Declarative Manifest: Ensure all tools and resources are declared in the manifest with their schemas, descriptions, and metadata.
  • Isolation: Tools should be stateless and not share mutable state. Use context objects for per-request data.
  • Extensibility: New tools/resources should be easy to add by implementing a handler and updating the manifest/registry.

References

© adeze, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/mcp-development of adeze/raindrop-mcp.

Open the folder on GitHubat commit 5b1e7f9

Compare with similar skills

MCP Development next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP Development this skilladeze/raindrop-mcp188—~855Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official37k11 repos~3.1kAutomated safety check: PassApache-2.0
Fastmcp Client CLIPrefectHQ/fastmcp28k1 repos~823Automated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    37k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed

  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub starsUsed in 1 repo~823 tokens
    Agent WorkflowsAuto-check passed

  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from adeze/raindrop-mcp

  • MCP Inspector

    adeze/raindrop-mcp

    MCP Protocol Inspection and Debugging with Inspector CLI. An agent skill from adeze/raindrop-mcp.

    188 GitHub stars~421 tokensUpdated 2 mo ago
    Auto-check passed

  • MCP Refactoring

    adeze/raindrop-mcp

    Refactoring MCP Tools for Better LLM Integration and Usability

    188 GitHub stars~972 tokensUpdated 2 mo ago
    Auto-check passed

  • MCP Testing

    adeze/raindrop-mcp

    MCP Testing Strategies with Vitest, Inspector, and Integration Tests

    188 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed

  • Publishing

    adeze/raindrop-mcp

    Publishing and release workflow with semantic-release and GitHub Actions

    188 GitHub stars~398 tokensUpdated 2 mo ago
    Auto-check passed

  • Dxt Packaging

    adeze/raindrop-mcp

    MCPB (Model Context Protocol Bundle) Packaging and Distribution

    188 GitHub stars~572 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about MCP Development

What does MCP Development do?

MCP Server Development Patterns and Best Practices. An agent skill from adeze/raindrop-mcp. MCP Development is an agent skill from adeze/raindrop-mcp.

When should I use MCP Development?

MCP Development fits situations like: tasks that involve MCP servers.

How do I install MCP Development in Claude Code?

Run `npx skills add adeze/raindrop-mcp --skill mcp-development -a claude-code`. Or copy the skill folder (.github/skills/mcp-development in adeze/raindrop-mcp) into .claude/skills/mcp-development in your project. Claude Code loads it when a task matches its description.

How do I install MCP Development in Codex?

Run `npx skills add adeze/raindrop-mcp --skill mcp-development -a codex`. Or copy the skill folder (.github/skills/mcp-development in adeze/raindrop-mcp) into .agents/skills/mcp-development in your project. Codex loads it when a task matches its description.

Can I use MCP Development in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adeze/raindrop-mcp --skill mcp-development -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-development, .gemini/skills/mcp-development, .github/skills/mcp-development and .opencode/skills/mcp-development in your project.

What does MCP Development need to run?

SKILL.md names no scripts, command-line tools or credentials: MCP Development is instructions for the agent only.

Does MCP Development access the network?

SKILL.md names 4 domains. As links in the text: github.com, modelcontextprotocol.io, vitest.dev and developer.raindrop.io. This is read from the text; nothing was executed.

Is MCP Development safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP Development use?

MCP Development is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP Development use?

About 855 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to MCP Development?

Skills that share tags, products or a category with MCP Development: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 37k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Development?

adeze (a GitHub user) maintains it in adeze/raindrop-mcp, which has 188 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on July 24, 2026.

Source: adeze/raindrop-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.