Skip to main content
Glama
MCP Starter Kit

MCP Starter Kit

MCP Starter Kit

Plantilla para construir tu propio servidor MCP (Model Context Protocol) en TypeScript y conectarlo a opencode (o Claude Desktop, Cursor, etc.).

Con un MCP, un modelo de IA puede usar herramientas que tú defines: abrir una app de tu computador, leer tus notas, llamar a una API, controlar música… lo que se te ocurra.

⚡ Empezar (Windows y Mac, sin escribir comandos complicados)

Opción recomendada: pegar UNA línea en la terminal

Descarga e instala todo sin que Windows ni macOS muestren alertas de "archivo peligroso" (esas alertas solo aparecen en archivos bajados con el navegador).

Windows — abre PowerShell (menú Inicio → escribe PowerShell) y pega:

irm https://raw.githubusercontent.com/Maurichilean3d/mcp-starter-kit/main/install.ps1 | iex

Mac (Apple Silicon o Intel) — abre Terminal (Cmd+Espacio → Terminal) y pega:

curl -fsSL https://raw.githubusercontent.com/Maurichilean3d/mcp-starter-kit/main/install.sh | bash

Esto copia el kit a tu carpeta de usuario (mcp-starter-kit) y abre el instalador. Es seguro revisar antes lo que hace: son los archivos install.ps1 / install.sh de este mismo repositorio.

Opción alternativa: descargar el ZIP

  1. En esta página pulsa el botón verde Code → Download ZIP y descomprímelo (en Windows: clic derecho → Extraer todo...; no lo ejecutes desde dentro del .zip).

  2. Haz doble clic en el archivo de entrada:

Windows

macOS

Iniciar.bat

Iniciar.command

Como el ZIP viene del navegador, el sistema puede mostrar un aviso la primera vez:

  • Windows: "Windows protegió su PC" → Más información → Ejecutar de todas formas.

  • Mac: "…podría ser peligroso" o "no se puede abrir". Abre Terminal y pega (cambia la ruta si lo descomprimiste en otro sitio):

    xattr -dr com.apple.quarantine ~/Downloads/mcp-starter-kit-main
    bash ~/Downloads/mcp-starter-kit-main/Iniciar.command

    Con bash … también se evita el error "permiso denegado" del ZIP de GitHub. La alerta desaparece del todo solo si el archivo está firmado con una cuenta de desarrollador de Apple de pago, que este proyecto no tiene.

Qué hace

El programa te va preguntando [S/N] antes de instalar lo que falte (Node.js, opencode, Antigravity), prepara el MCP y abre un menú:

  1. Crear un MCP para una app de tu equipo (Constructor automático)

  2. Abrir opencode con el MCP del kit

  3. Abrir Antigravity con el MCP del kit

  4. Conectar o cambiar la IA (NVIDIA / OpenRouter / ninguna) — ver guía 9

  5. Diagnóstico (si algo falla: crea diagnostico.txt para enviarlo a quien te ayuda)

La primera vez tarda un par de minutos; después abre al instante.

¿Prefieres git? git clone https://github.com/Maurichilean3d/mcp-starter-kit.git y luego el mismo archivo de entrada (con git tampoco aparecen alertas).

Mac Intel vs Apple Silicon: es el mismo archivo Iniciar.command para los dos; detecta solo si tu Mac es Intel o Apple Silicon (M1/M2/M3…) y descarga la versión de Node.js que corresponde, sin pedir contraseña de administrador (queda en ~/.mcp-starter-kit/node). opencode se instala con npm; si falla por permisos se instala en tu carpeta de usuario (~/.local), y como último recurso con el instalador oficial. Cada MCP que crees trae su doble clic Abrir-<nombre>.command (Mac) / Abrir-<nombre>.bat (Windows), que abre la app y opencode con el MCP a la vez, y Cerrar-<nombre> para cerrarlos.

Más detalle y solución de problemas: docs/00-instalacion-windows-mac.md y docs/06-depuracion.md. El constructor automático (con sus advertencias de seguridad): docs/07-constructor-automatico.md.

Related MCP server: Example MCP Server

Inicio rápido con la terminal (cualquier sistema)

Requisitos: Node.js 18+ y opencode.

git clone https://github.com/TU-USUARIO/mcp-starter-kit.git mi-mcp
cd mi-mcp
npm install
npm run build
npm test            # debe terminar con "Prueba de humo superada."

Luego abre opencode en esta misma carpeta (opencode). El archivo opencode.json ya registra el MCP. Pregúntale:

"Usa la herramienta saludar para saludar a Ana"
"Lista mis aplicaciones instaladas y abre la calculadora"

Qué incluye

install.ps1 / install.sh        Instalacion por una linea de terminal (sin alertas del sistema)
Iniciar.bat / Iniciar.command   Punto de entrada unico (Windows / Mac): instala lo que falte y abre el menu
instalador/             Programa que hace la instalacion y el menu (setup.mjs) + generador de instaladores
constructor/            App web local que hace que opencode construya un MCP por ti
src/
  index.ts              Arranque del servidor (carga src/tools/ automáticamente)
  tools/
    ejemplo.ts          Herramientas mínimas: hora_actual, saludar
    aplicaciones.ts     Ejemplo real: listar y abrir apps (macOS/Windows/Linux)
  lib/
    exec.ts             Ejecutar programas de forma segura
    respuestas.ts       Helpers: texto(), json(), error()
templates/
  tool.template.ts      Plantilla de herramienta nueva
  PROMPT_PARA_OPENCODE.md   Prompt listo para que opencode construya tu MCP
scripts/
  new-tool.mjs          Generador de herramientas
  smoke-test.mjs        Prueba automática
  configurar-opencode.mjs   Registra el MCP en opencode con ruta absoluta
  asegurar-clis.mjs     Detecta/instala opencode y Antigravity (pide permiso)
  diagnostico.mjs       Revisa Node, npm, opencode, internet... y crea diagnostico.txt
  lanzar.mjs            Abre opencode o Antigravity con el MCP
docs/                   Guías paso a paso (léelas en orden)
AGENTS.md               Reglas que opencode lee automáticamente
opencode.json           Registro del MCP en opencode

Crear tu propio MCP

Camino A — a mano

npm run new-tool -- crear_nota     # crea src/tools/crear_nota.ts
# edita el archivo, luego:
npm run build

Reinicia opencode y tu herramienta aparece sola. No hay que registrar nada.

Camino B — con ayuda de opencode (recomendado para apps)

Abre templates/PROMPT_PARA_OPENCODE.md, elige la app de tu computador, completa el prompt y pégalo en opencode. Gracias a AGENTS.md, opencode ya conoce las reglas del proyecto.

Guías

  1. Instalación y primer uso (Windows y macOS)

  2. Conceptos: qué es MCP

  3. Tu primer MCP paso a paso

  4. Conectar con opencode (y otros clientes)

  5. Construir un MCP para una aplicación

  6. Seguridad y buenas prácticas

  7. Depuración y problemas comunes

  8. Constructor automático: opencode escribe el MCP por ti

  9. Instalar opencode, conectar NVIDIA/OpenRouter y usar agy

Comandos

Comando

Qué hace

npm run setup

Instala lo que falte y abre el menú (igual que Iniciar)

npm run crear-mcp

Abre el Constructor automático de MCP

npm run build

Compila TypeScript a dist/

npm test

Compila y verifica que el servidor responde

npm run inspect

Abre el MCP Inspector (interfaz visual para probar herramientas)

npm run new-tool -- nombre

Crea una herramienta nueva

npm run configurar

Registra el MCP en opencode (ruta absoluta)

npm run configurar:global

Lo registra para todas las carpetas

npm run dev

Ejecuta el servidor directo desde TypeScript

Licencia

MIT

Available Tools

4 tools
abrir_aplicacionAbrir aplicacionA

Abre una aplicacion instalada por su nombre (ej: 'Safari', 'Notepad', 'firefox'). Opcionalmente abre un archivo con ella.

Inputs: nombre (required), archivo.

hora_actualHora actualA
Read-only

Devuelve la fecha y hora actual del computador del usuario.

Inputs: no named parameters.

listar_aplicacionesListar aplicacionesA
Read-only

Lista las aplicaciones instaladas en el computador del usuario. Usala antes de abrir una app si no conoces su nombre exacto.

Inputs: filtro.

saludarSaludarA
Read-only

Saluda a una persona por su nombre. Util para probar que el MCP funciona.

Inputs: nombre (required), idioma.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: listing apps, opening apps, getting the current time, and greeting a person. There is no meaningful overlap that would cause an agent to misselect a tool.

    Naming Consistency4/5

    Tool names are consistently snake_case and mostly follow a verb_noun pattern. However, 'hora_actual' is noun_adjective and 'saludar' is a bare verb, which are minor deviations from the dominant naming style.

    Tool Count5/5

    Four tools is a well-scoped size for a starter kit, with each tool serving a simple, clear purpose. Nothing feels excessive or missing for the stated demo-oriented scope.

    Completeness3/5

    For desktop app interaction, the set covers listing and opening apps but lacks an obvious close/quit operation or app-state inspection. The time and greeting tools are useful starter utilities but do not fill that lifecycle gap.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
      1
      37
      MIT
    • F
      license
      C
      quality
      Not graded
      maintenance
      A minimal Node.js Model Context Protocol server that exposes two simple tools ('add' and 'getTime') that can be called from AI assistants like Claude Desktop or Cursor.
      2
      -
    • A
      license
      B
      quality
      C
      maintenance
      A Node.js and TypeScript implementation that provides system information and health check tools for Claude Desktop. It serves as a boilerplate for building and integrating custom tools using the Model Context Protocol.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A local Model Context Protocol (MCP) server that exposes custom tools to Claude Desktop, enabling direct interaction with your local environment. It provides a framework for building and integrating custom TypeScript tools into the Claude interface.
      MIT