Skip to main content
Glama
my-mcp-server

my-mcp-server

by RianHarahap

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.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to expose arbitrary HTTP APIs as configurable MCP tools by defining tool specifications in a JSON configuration file.
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI clients to connect to example tools, resources, and prompts over MCP, demonstrating integration with IDEs, chatbots, and agent frameworks.
      -