菜单
Deep patterns for @outfitter/mcp including tool registration, Zod schemas, resources, and server configuration. Use when building MCP servers, registering tools, defining resources, or when "MCP server", "MCP tool", "registerTool", or "@outfitter/mcp" are mentioned.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/outfitter-dev/outfitter --skill outfitter-mcp命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Patterns for @outfitter/daemon including lifecycle management, IPC communication, health checks, and PID files. Use when building background services, daemons, or when "daemon", "IPC", "health check", "background service", or "@outfitter/daemon" are mentioned.
Creates handlers, CLI commands, MCP tools, and daemon services following Outfitter Dev Kit conventions. Use when adding new components to a project, scaffolding code, or when "create handler", "new command", "add tool", or "daemon service" are mentioned.
Generates patterns, templates, and guides for @outfitter/* packages. Covers transport-agnostic handler systems, Result types, error taxonomy, and package APIs. Use when working with @outfitter/*, Result types, Handler contract, error taxonomy, or when Result, Handler, ValidationError, NotFoundError, OutfitterError, or package names like contracts, cli, mcp, schema, tui, daemon, config, logging are mentioned.
正在显示 SKILL.md
| name | outfitter-mcp |
| version | 0.1.0 |
| description | Deep patterns for @outfitter/mcp including tool registration, Zod schemas, resources, and server configuration. Use when building MCP servers, registering tools, defining resources, or when "MCP server", "MCP tool", "registerTool", or "@outfitter/mcp" are mentioned. |
| allowed-tools | Read Write Edit Glob Grep |
Deep dive into @outfitter/mcp patterns.
import { createMcpServer } from "@outfitter/mcp";
const server = createMcpServer({
name: "my-server",
version: "0.1.0",
description: "Server for AI agents",
});
// Register tools before start
server.registerTool(searchTool);
server.registerTool(createTool);
// Start server
server.start();
import { Result, ValidationError } from "@outfitter/contracts";
import { z } from "zod";
const InputSchema = z.object({
query: z.string().min(1).describe("Search query"),
limit: z.number().int().positive().default(10).describe("Max results"),
});
export const searchTool = {
name: "search",
description: "Search for items. Use when user asks to find or search.",
inputSchema: InputSchema,
handler: async (
input: z.infer<typeof InputSchema>
): Promise<Result<SearchOutput, ValidationError>> => {
const results = await performSearch(input.query, input.limit);
return Result.ok({ results, total: results.length });
},
};
const InputSchema = z.object({
// Always use .describe() for AI understanding
query: z.string().describe("The search term to look for"),
// Provide defaults where sensible
limit: z.number().default(10).describe("Maximum number of results"),
// Use enums for fixed choices
sortBy: z
.enum(["name", "date", "relevance"])
.default("relevance")
.describe("Field to sort results by"),
// Mark optional fields explicitly
tags: z.array(z.string()).optional().describe("Filter by tags"),
});
export const myTool = {
name: "my_tool",
description: "Tool description",
inputSchema: InputSchema,
handler: async (input, ctx) => {
ctx.logger.debug("Tool invoked", { input });
const result = await myHandler(input, ctx);
if (result.isErr()) {
ctx.logger.error("Tool failed", { error: result.error });
}
return result;
},
};
server.registerResource({
uri: "config://settings",
name: "Configuration",
description: "Current server configuration",
mimeType: "application/json",
read: async () => {
return JSON.stringify(config, null, 2);
},
});
server.registerResource({
uri: "data://users/{id}",
name: "User Data",
description: "User information by ID",
mimeType: "application/json",
read: async (uri) => {
const id = uri.split("/").pop();
const user = await getUser(id);
return JSON.stringify(user);
},
});
server.registerResourceList({
uri: "data://users",
name: "Users",
description: "List of all users",
list: async () => {
const users = await getAllUsers();
return users.map((u) => ({
uri: `data://users/${u.id}`,
name: u.name,
description: u.email,
}));
},
});
server.registerPrompt({
name: "analyze",
description: "Analyze data with specific focus",
arguments: [
{ name: "focus", description: "What to focus on", required: true },
{ name: "depth", description: "Analysis depth", required: false },
],
get: async (args) => {
return {
messages: [
{
role: "user",
content: {
type: "text",
text: `Analyze with focus on: ${args.focus}. Depth: ${args.depth || "normal"}`,
},
},
],
};
},
});
handler: async (input) => {
if (!input.query) {
return Result.err(ValidationError.create("query", "is required"));
}
const item = await findItem(input.id);
if (!item) {
return Result.err(NotFoundError.create("item", input.id));
}
return Result.ok(item);
};
| Category | MCP Behavior |
|---|---|
| validation | Tool returns error with details |
| not_found | Tool returns error with resource info |
| internal | Tool returns generic error, logs full error |
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"my-server": {
"command": "bun",
"args": ["run", "/path/to/server.ts"]
}
}
}
{
"mcpServers": {
"my-server": {
"command": "bun",
"args": ["run", "/path/to/server.ts"],
"env": {
"API_KEY": "secret",
"LOG_LEVEL": "debug"
}
}
}
}
For tools that are expensive to load:
server.registerDeferredTool({
name: "heavy_tool",
description: "Expensive tool loaded on demand",
load: async () => {
const { heavyTool } = await import("./heavy-tool.js");
return heavyTool;
},
});
import { createMcpHarness } from "@outfitter/testing";
// Pass the full McpServer instance, not individual tools
const harness = createMcpHarness(server);
test("tool returns results", async () => {
const result = await harness.callTool("my-tool", { query: "test" });
expect(result.isOk()).toBe(true);
expect(result.value.results).toHaveLength(3);
});
.describe() on every field.default() where appropriatecreateMcpHarness for testingstack:patterns — Handler contractstack:scaffold — MCP tool templatestack:debug — Troubleshooting MCP issues基于 SOC 职业分类