My MCP Server (para principiantes)

Servidor MCP (Model Context Protocol) creado por ti mismo con:

• Módulo de clave API y URL propias a través del archivo .env

• Herramientas de ejemplo: echo y call_my_api

• Listo para probar con MCP Inspector

• Listo para usar directamente en VS Code (GitHub Copilot Chat)

1. Instalar dependencias

npm install

Related MCP server: mcp-server-demo

2. Crear el archivo .env

Copia .env.example a .env y luego complétalo con tu clave API y tu URL:

Copy-Item .env.example .env

Contenido de .env:

MY_API_KEY=api-key-asli-kamu
MY_API_BASE_URL=https://api.contohkamu.com
MCP_SERVER_NAME=my-mcp-server

⚠️ Nunca hagas commit del archivo .env a git. Este archivo ya se ignora automáticamente mediante .gitignore.

3. Compilar el proyecto

npm run build

Este comando compila el TypeScript de src/ a JavaScript en build/.

4. Probar con MCP Inspector

MCP Inspector es una herramienta visual (navegador) para probar tus herramientas MCP sin necesidad de otro cliente.

npm run inspector

Esto ejecutará npx @modelcontextprotocol/inspector node build/index.js y abrirá el Inspector en el navegador. Desde allí puedes:

1. Haz clic en la pestaña Tools

2. Elige la herramienta echo o call_my_api

3. Completa los parámetros, haz clic en Run Tool y mira el resultado

5. Usar directamente en VS Code

El archivo .vscode/mcp.json ya está preparado. Abre la Paleta de comandos → MCP: List Servers → elige my-mcp-server → Start Server. Este servidor lee automáticamente .env mediante envFile.

Estructura del proyecto

├── .env                  # rahasia kamu (tidak di-commit)
├── .env.example          # contoh isi .env
├── .vscode/mcp.json      # konfigurasi MCP untuk VS Code
├── src/
│   ├── config.ts         # loader environment variable
│   ├── apiClient.ts      # modul pemanggilan API eksternal (pakai API key & URL)
│   └── index.ts          # server MCP utama + daftar tool
├── package.json
└── tsconfig.json

Añadir una nueva herramienta

Añade un nuevo bloque server.registerTool("nama_tool", { ... }, async (input) => { ... }) en src/index.ts y vuelve a ejecutar npm run build.

Solución de problemas

• Error «Variable de entorno ... no está configurada» → asegúrate de que .env exista y esté completo.

• La herramienta call_my_api falla → comprueba si MY_API_BASE_URL y MY_API_KEY son correctos y si el endpoint de la API admite la cabecera Authorization: Bearer <key>.

• El Inspector no se abre → asegúrate de haber ejecutado npm run build antes.