Skip to main content
Glama
Merlin21x

Basic MCP Server

by Merlin21x
README.md
# MCP Básico para GitHub Copilot

Este proyecto implementa un servidor básico Model Context Protocol (MCP) en TypeScript, siguiendo las mejores prácticas y la especificación oficial. Está diseñado para ser utilizado y depurado con GitHub Copilot y otros clientes MCP compatibles.

## Recursos útiles
- [Documentación oficial de MCP](https://modelcontextprotocol.io/)
- [SDK TypeScript](https://github.com/modelcontextprotocol/typescript-sdk)
- [Ejemplo de servidores MCP](https://github.com/modelcontextprotocol/servers)

## Estructura mínima
- Servidor MCP básico en TypeScript
- Configuración para stdio (recomendado para integración local con VS Code y Copilot)
- Archivos de configuración para VS Code y MCP

## Pasos para iniciar
1. Instala Node.js 16+ y npm.
2. Instala las dependencias:
   ```powershell
   npm install @modelcontextprotocol/sdk zod
   npm install -D typescript @types/node
   ```
3. Compila el servidor:
   ```powershell
   npx tsc
   ```
4. Ejecuta el servidor MCP:
   ```powershell
   node build/index.js
   ```
5. Configura tu cliente MCP (por ejemplo, Claude Desktop, VS Code Copilot) para conectar con este servidor usando stdio.

## Seguridad y mejores prácticas
- No escribas en stdout desde el servidor, solo usa stderr para logs.
- Consulta la [guía de seguridad MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/security_best_practices) para detalles sobre autenticación y autorización.

---

Este proyecto es un punto de partida. Personalízalo según tus necesidades y consulta la documentación oficial para aprovechar todo el potencial de MCP.

TDQS

B3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The tool 'hello_world' has a single, clear purpose that cannot be mistaken for any other functionality.

Naming Consistency5/5

The single tool name 'hello_world' follows a common snake_case pattern, and since there is only one tool, consistency is inherently perfect. There are no other tools to compare against, so no inconsistencies can arise.

Tool Count2/5

A single tool is too few for most practical server purposes, as it severely limits functionality and scope. While it might be appropriate for a minimal demo, it feels thin and inadequate for any real-world application or domain coverage.

Completeness1/5

The server's purpose is unclear from the single tool, but for any inferred domain (e.g., greetings or basic interactions), the surface is severely incomplete. With only a 'hello_world' tool, there are obvious gaps in operations like customization, querying, or other related actions, making it impossible to perform meaningful workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues