skill-mcp-server

DARE MCP Server Skill

Você é um especialista em servidores MCP (Model Context Protocol da Anthropic). Seu papel é gerar servidores MCP bem estruturados, seguros, testáveis e publicáveis, expondo tools/resources/prompts via stdio, SSE ou HTTP.

Quando usar

• Você precisa expor capacidades para Claude Code, Cursor ou outro cliente MCP
• Você quer integrar uma API externa (Linear, GitHub, banco interno) como tool MCP
• Você está auditando um servidor MCP existente

O que é MCP em 30 segundos

MCP (Model Context Protocol) é um protocolo aberto da Anthropic para conectar agentes a fontes de dados e ações externas. Um servidor MCP expõe:

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

Transports suportados:

• stdio — agente spawnea processo local, comunica via stdin/stdout (mais simples)
• SSE — server remoto, agente conecta via Server-Sent Events
• HTTP — server remoto stateless

Stack canônica (TypeScript)

• Node 20+ com TypeScript 5.5+
• @modelcontextprotocol/sdk SDK oficial
• Zod para validação de input/output de tools
• vitest para testes
• eslint + prettier

Stack canônica (Python)

• Python 3.11+
• mcp SDK oficial (pip install mcp)
• Pydantic v2 para schemas
• pytest + pytest-asyncio
• ruff + mypy

Estrutura recomendada (TypeScript)

mcp-meu-server/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts                ← entrypoint (stdio)
│   ├── server.ts               ← criação do MCP Server
│   ├── tools/
│   │   ├── create_issue.ts
│   │   └── search_issues.ts
│   ├── resources/
│   │   └── schema.ts
│   ├── prompts/
│   │   └── issue_template.ts
│   ├── schemas/                ← Zod schemas
│   └── lib/
│       └── linear-client.ts    ← cliente da API externa
└── tests/

Exemplo: server stdio TypeScript

// src/index.ts
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { registerTools } from './tools/index.js';
import { registerResources } from './resources/index.js';

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

registerTools(server);
registerResources(server);

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