Skip to main content
Glama

basic-mcp

Un servidor MCP (Model Context Protocol) con una interfaz de React, que expone herramientas y recursos sobre usuarios de GitHub y el clima.

Estructura del proyecto

basic-mcp/
├── server/          # Serveur MCP (Node.js / TypeScript)
│   ├── main.ts      # Point d'entrée — transport stdio
│   ├── server-http.ts # Point d'entrée — transport HTTP (Streamable HTTP)
│   └── src/
│       ├── application/   # Cas d'usage (GetGitHubUser, GetWeather)
│       ├── domain/        # Entités et ports (interfaces)
│       ├── infrastructure/ # Implémentations des repositories
│       └── interface/mcp/ # Outils et ressources MCP exposés
└── client/          # Interface React + Vite
    └── src/
        ├── application/hooks/  # useMcpTool, useMcpResource
        ├── domain/             # Entités côté client
        ├── infrastructure/mcp/ # Adaptateur MCP client
        └── presentation/       # Composants React

Requisitos previos

  • Node.js >= 18

  • npm >= 9

Instalación

npm install
cd client && npm install

Inicio

Solo servidor (stdio)

npm run start

Servidor HTTP (puerto 3001)

npm run start:http

Servidor HTTP + Interfaz React

npm run start:ui

La interfaz es accesible en http://localhost:5173. El servidor MCP HTTP escucha en http://localhost:3001/mcp.

Herramientas MCP disponibles

Herramienta

Descripción

ping

Verifica que el servidor responda

get-github-user

Devuelve la información de un usuario de GitHub

get-weather

Devuelve el clima para una latitud/longitud

Recursos MCP disponibles

URI

Descripción

github-user://{username}

Perfil de GitHub de un usuario

weather://{lat},{lon}

Clima para coordenadas GPS

Arquitectura

El proyecto sigue los principios de la Arquitectura Limpia (Clean Architecture):

  • Dominio — entidades e interfaces de puertos (sin dependencias externas)

  • Aplicación — casos de uso que orquestan la lógica de negocio

  • Infraestructura — llamadas HTTP a APIs externas (GitHub, Open-Meteo)

  • Interfaz — exposición a través del protocolo MCP

F
license - not found
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tchoupoGuy/basic-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server