skill-mcp-server

/skill-mcp-server

Padrões DARE para servidores MCP (Model Context Protocol) em TypeScript ou Python. Tools, resources, prompts; transports stdio/SSE/HTTP; validação Zod/Pydantic; autorização por tool; tracing; testes; publicação.

Como usar

/skill-mcp-server                            # audita server MCP atual
/skill-mcp-server scaffold ts                # scaffold TypeScript stdio
/skill-mcp-server scaffold py                # scaffold Python stdio

O que é MCP

Protocolo aberto da Anthropic para conectar agentes a fontes de dados e ações. Server expõe:

• Tools — funções chamáveis (ex: create_issue)
• Resources — dados leitáveis (ex: schemas)
• Prompts — templates parametrizados

Transports: stdio (local), SSE (remoto streaming), HTTP (remoto stateless).

Stack (TypeScript)

• Node 20+ + TS 5.5+
• @modelcontextprotocol/sdk
• Zod para schemas
• vitest

Stack (Python)

• Python 3.11+
• mcp (SDK oficial)
• Pydantic v2
• pytest + pytest-asyncio

Estrutura

mcp-server/
├── src/
│   ├── index.ts            ← stdio entrypoint
│   ├── server.ts
│   ├── tools/
│   ├── resources/
│   ├── prompts/
│   └── schemas/
└── tests/

Exemplo (TypeScript stdio)

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

const CreateIssueInput = z.object({
  title: z.string().min(1).max(255),
  description: z.string().optional(),
  priority: z.enum(['low', 'medium', 'high']).default('medium'),
  team_id: z.string().uuid(),
});

const server = new Server(
  { name: 'meu-server', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: 'create_issue',
    description: 'Create a new issue in Linear',
    inputSchema: CreateIssueInput.shape,
  }],
}));

server.setRequestHandler(CallToolRequestSchema, async (req) => {
  const input = CreateIssueInput.parse(req.params.arguments);
  const result = await linearClient.createIssue(input);
  return { content: [{ type: 'text', text: JSON.stringify(result) }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);