Skip to main content
Glama

basic-mcp

Un serveur MCP (Model Context Protocol) avec une interface React, exposant des outils et ressources autour des utilisateurs GitHub et de la météo.

Structure du projet

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

Prérequis

  • Node.js >= 18

  • npm >= 9

Installation

npm install
cd client && npm install

Démarrage

Serveur seul (stdio)

npm run start

Serveur HTTP (port 3001)

npm run start:http

Serveur HTTP + Interface React

npm run start:ui

L'interface est accessible sur http://localhost:5173.
Le serveur MCP HTTP écoute sur http://localhost:3001/mcp.

Outils MCP disponibles

Outil

Description

ping

Vérifie que le serveur répond

get-github-user

Retourne les infos d'un utilisateur GitHub

get-weather

Retourne la météo pour une latitude/longitude

Ressources MCP disponibles

URI

Description

github-user://{username}

Profil GitHub d'un utilisateur

weather://{lat},{lon}

Météo pour des coordonnées GPS

Architecture

Le projet suit les principes de la Clean Architecture :

  • Domain — entités et interfaces de ports (aucune dépendance externe)

  • Application — cas d'usage orchestrant la logique métier

  • Infrastructure — appels HTTP aux APIs externes (GitHub, Open-Meteo)

  • Interface — exposition via le protocole 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