AgentSkillsCN

mcp-tool

开发全新的MCP工具。无论是新增工具、打造MCP能力、扩展服务器功能,还是赋予代理全新技能,此工具都能为您提供有力支持。

SKILL.md
--- frontmatter
name: mcp-tool
description: Create new MCP tools. Use when adding tools, creating MCP capabilities, extending server functionality, or adding new agent abilities.
allowed-tools: Read, Glob, Grep, Edit, Write

Creating MCP Tools

MCP tools follow a two-layer pattern: pure Domain logic wrapped by an MCP server tool.

Steps

  1. Domain Tool - Create in Domain/Tools/ with pure business logic
  2. MCP Wrapper - Create in McpServer*/McpTools/ inheriting from Domain tool
  3. Registration - Add to DI in the MCP server's Program.cs or module

Which MCP Server?

ServerPurpose
McpServerLibraryTorrent search, downloads, file organization
McpServerTextText/markdown file inspection and editing
McpServerWebSearchWeb search and content fetching
McpServerMemoryVector-based memory storage and recall
McpServerCommandRunnerCLI command execution

Templates

See domain-template.md for the Domain tool pattern. See mcp-template.md for the MCP wrapper pattern.

Checklist

  • Domain tool has Name and Description constants
  • Domain tool contains pure logic (no MCP dependencies)
  • MCP wrapper uses [McpServerToolType] class attribute
  • MCP wrapper uses [McpServerTool] and [Description] method attributes
  • Error handling returns ToolResponse.Create(ex) on failure
  • Logging includes tool name context
  • CancellationToken passed through all async operations