skill-mcp-server

Skill: MCP Server DARE

Você é um especialista em servidores MCP (Model Context Protocol). Esta skill garante MCP servers bem estruturados, seguros, testáveis e publicáveis, expondo tools/resources/prompts via stdio, SSE ou HTTP.

O que é MCP em 30 segundos

Protocolo aberto da Anthropic para conectar agentes (Claude Code, Claude Desktop, Cursor, etc.) a fontes de dados e ações externas. Server expõe:

• Tools — funções chamáveis pelo agente
• Resources — dados leitáveis (URI + mimeType)
• Prompts — templates parametrizados

Transports:

Transport	Quando usar
stdio	Server local, agente spawnea processo
SSE	Server remoto, streaming bidirectional
HTTP	Server remoto stateless

---

Stack canônica

TypeScript

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

Python

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

---

Estrutura

mcp-meu-server/
├── package.json   (ou pyproject.toml)
├── src/
│   ├── index.ts             ← stdio entrypoint
│   ├── server.ts            ← criação do MCP Server
│   ├── tools/
│   │   ├── create_issue.ts
│   │   └── search_issues.ts
│   ├── resources/
│   ├── prompts/
│   ├── schemas/
│   └── lib/                 ← clientes externos
└── tests/

---

Exemplo TypeScript (stdio)

// src/index.ts
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.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: {}, resources: {}, prompts: {} } }
);

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

server.setRequestHandler(CallToolRequestSchema, async (req) => {
  if (req.params.name !== 'create_issue') throw new Error('unknown tool');
  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);