Skip to main content
Glama
MCP Hello World Server

MCP Hello World Server

by Cedricnator

MCP Hello World Server

Este es un servidor MCP (Model Context Protocol) de ejemplo que demuestra cómo crear herramientas personalizadas que pueden ser utilizadas por LLMs como Claude.

🚀 ¿Qué es MCP?

El Model Context Protocol (MCP) es un protocolo estandarizado creado por Anthropic que permite a los modelos de lenguaje (LLMs) interactuar con herramientas externas y fuentes de datos de manera consistente.

Related MCP server: MCP Calculator Demo

📋 Herramientas Disponibles

Este servidor incluye dos herramientas de ejemplo:

  1. say_hello: Devuelve un saludo personalizado

    • Parámetros: name (string)

  2. calculate_sum: Calcula la suma de dos números

    • Parámetros: a (number), b (number)

🛠️ Instalación

npm install

▶️ Uso

Ejecutar el servidor directamente:

npm start

o

node index.js

🔧 Configuración con Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrega la siguiente configuración a tu archivo de configuración de Claude:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-hello-world": {
      "command": "node",
      "args": ["/ruta/completa/a/tu/proyecto/index.js"]
    }
  }
}

Reemplaza /ruta/completa/a/tu/proyecto/ con la ruta real donde está tu proyecto.

📝 Estructura del Código

El servidor MCP implementa:

  • ListToolsRequestSchema: Define las herramientas disponibles

  • CallToolRequestSchema: Maneja la ejecución de las herramientas

  • StdioServerTransport: Comunicación estándar con el cliente MCP

🎯 Próximos Pasos

Puedes expandir este servidor agregando más herramientas:

  1. Integración con APIs externas

  2. Acceso a bases de datos

  3. Operaciones de archivos

  4. Cálculos complejos

  5. Y mucho más...

📚 Recursos

📄 Licencia

ISC

mcp_hello

mcp_hello

mcp_hello

Available Tools

2 tools
calculate_sumB

Calcula la suma de dos números

Inputs: a (required), b (required).

say_helloB

Devuelve un saludo personalizado con el nombre proporcionado

Inputs: name (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: calculate_sum performs a mathematical operation on two numbers, while say_hello generates a personalized greeting. There is no overlap in functionality, making it impossible for an agent to confuse them.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (calculate_sum and say_hello), using snake_case throughout. The verbs 'calculate' and 'say' clearly indicate the action, and the nouns 'sum' and 'hello' specify the target, creating a predictable and readable convention.

    Tool Count2/5

    With only two tools, this server feels too thin for a general-purpose 'Hello World Server' that might imply broader utility. The tools cover basic math and greetings, but the count is minimal and lacks depth for meaningful agent workflows, suggesting an incomplete or overly simplistic implementation.

    Completeness2/5

    Given the server name 'MCP Hello World Server', which suggests a demonstration or introductory toolset, the surface is severely incomplete. It lacks common 'hello world' elements like file operations, API testing, or configuration tools, and the two provided tools do not form a coherent domain or support typical agent tasks beyond trivial examples.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A sample MCP server that provides basic arithmetic tools like addition, subtraction, multiplication, and division. It serves as a demonstration for implementing the Model Context Protocol and connecting custom tools to clients like Claude Desktop.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A demonstration project showing how to set up and use a custom MCP server with Claude Desktop, providing example tools and resources.
      -