convez.ai
MCP ServerIntegração & APIsIntermediário
enzoemir1

MCP Server Starter

enzoemir1/mcp-server-starter

Template de MCP server TypeScript pronto para produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Template mínimo e pronto para produção de um servidor Model Context Protocol em TypeScript. Inclui dois transportes (stdio e HTTP), ferramentas tipadas com Zod, exemplos de recursos e prompts, além de testes e CI configurados. Clone e lance seu próprio servidor MCP em minutos.

Instalação

$npx convez-ai enzoemir1/mcp-server-starter

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar um servidor MCP personalizado para integrar com Claude Desktop ou Cursor
  • Desenvolver ferramentas tipadas com validação automática via Zod
  • Implantar servidores MCP em ambientes serverless ou remotos via HTTP

Veredito

Excelente ponto de partida para quem quer construir servidores MCP em produção. O template elimina boilerplate, oferece padrões testados e documentação clara — ideal para não começar do zero.

README

A tradução para o português deste README ainda está na fila.

MCP Server Starter

A minimal, production-ready Model Context Protocol server template in TypeScript.

Clone it, add your tools, and ship an MCP server your AI assistant can use — in minutes.

CI License: MIT MCP

By Automatia BCN · Barcelona


Why this template

Most MCP examples are either toy snippets or buried inside a framework. This is the in-between you actually want to start a real server:

  • ✅ Typed tools with Zod input schemas — validation for free
  • ✅ Two transports — stdio (Claude Desktop / Cursor / Windsurf / VS Code) and StreamableHTTP (remote / serverless)
  • ✅ Tool + Resource + Prompt examples — the three MCP primitives, done right
  • ✅ Real tests — in-memory client↔server integration tests with node:test
  • ✅ CI across Node 18/20/22, MIT licensed, zero bloat

Quick start

git clone https://github.com/enzoemir1/mcp-server-starter.git
cd mcp-server-starter
npm install
npm run build
npm start          # runs on stdio

Run it over HTTP instead:

npm run start:http   # POST JSON-RPC to http://localhost:3000/mcp

Inspect it visually with the official MCP Inspector:

npm run inspect

Use it with Claude Desktop / Cursor

Add this to your client's MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "starter": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-starter/dist/index.js"]
    }
  }
}

Restart the client and your tools (echo, word_count, roll_dice) appear.

Add your own tool

Open src/tools.ts and copy the pattern:

server.registerTool(
  'my_tool',
  {
    title: 'My Tool',
    description: 'What it does (the model reads this to decide when to call it).',
    inputSchema: { name: z.string().describe('Who to greet') },
  },
  async ({ name }) => ({
    content: [{ type: 'text', text: `Hello, ${name}!` }],
  })
);

That's it — the Zod schema becomes the tool's JSON Schema automatically, inputs are validated before your handler runs, and the tool shows up in any MCP client.

Project layout

src/
  index.ts    # entry point — stdio + StreamableHTTP transports
  tools.ts    # your tools, resources, and prompts (start here)
test/
  server.test.ts  # in-memory integration tests

Scripts

ScriptWhat it does
npm run buildCompile TypeScript → dist/
npm startRun the server on stdio
npm run start:httpRun the server on HTTP (PORT, default 3000)
npm testRun the integration tests
npm run inspectOpen the MCP Inspector

Built something real?

This starter is the on-ramp. When you need MCP servers that are already built, tested, and registry-published, Automatia BCN ships production ones:

  • LeadPipe MCP — lead qualification: ingest → enrich → score → export to your CRM
  • InvoiceFlow MCP — invoicing: PDF invoices, late-payment risk, reminders, cash flow
  • ShopOps MCP — e-commerce ops: inventory forecasting, pricing, RFM, anomaly detection
  • AdOps MCP — ad analytics: Google & Meta Ads reporting, budget optimization, A/B testing

More at automatiabcn.com — Automate the chaos.

License

MIT © Automatia BCN

Ver o original no GitHub

Bom para

Relacionados