MCP Starter Kit
This MCP server lets an AI inspect and control local applications and perform simple utility actions.
List installed applications, optionally filtering by name.
Open an installed application by name, optionally with a file.
Get the current date and time from the user's computer.
Greet a person by name in Spanish or English, useful for testing that the MCP works.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Starter Kit List my installed apps and then open the calculator"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 | iexMac (Apple Silicon o Intel) — abre Terminal (Cmd+Espacio → Terminal) y pega:
curl -fsSL https://raw.githubusercontent.com/Maurichilean3d/mcp-starter-kit/main/install.sh | bashEsto 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
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).Haz doble clic en el archivo de entrada:
Windows | macOS |
|
|
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.commandCon
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ú:
Crear un MCP para una app de tu equipo (Constructor automático)
Abrir opencode con el MCP del kit
Abrir Antigravity con el MCP del kit
Conectar o cambiar la IA (NVIDIA / OpenRouter / ninguna) — ver guía 9
Diagnóstico (si algo falla: crea
diagnostico.txtpara 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 opencodeCrear 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 buildReinicia 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
Comandos
Comando | Qué hace |
| Instala lo que falte y abre el menú (igual que |
| Abre el Constructor automático de MCP |
| Compila TypeScript a |
| Compila y verifica que el servidor responde |
| Abre el MCP Inspector (interfaz visual para probar herramientas) |
| Crea una herramienta nueva |
| Registra el MCP en opencode (ruta absoluta) |
| Lo registra para todas las carpetas |
| Ejecuta el servidor directo desde TypeScript |
Licencia
MIT
Available Tools
4 toolsabrir_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 actualARead-only
Devuelve la fecha y hora actual del computador del usuario.
Inputs: no named parameters.
listar_aplicacionesListar aplicacionesARead-only
Lista las aplicaciones instaladas en el computador del usuario. Usala antes de abrir una app si no conoces su nombre exacto.
Inputs: filtro.
saludarSaludarARead-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
Scored across 4 tools
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.
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.
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.
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
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Related MCP Servers
- AlicenseDqualityDmaintenanceA foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.137MIT
- FlicenseCqualityNot gradedmaintenanceA 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-
- AlicenseBqualityCmaintenanceA 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.4MIT
- AlicenseNot gradedqualityDmaintenanceA 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