Skip to main content
Glama

basic-mcp

Сервер MCP (Model Context Protocol) с интерфейсом на React, предоставляющий инструменты и ресурсы для работы с пользователями GitHub и данными о погоде.

Структура проекта

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

Предварительные требования

  • Node.js >= 18

  • npm >= 9

Установка

npm install
cd client && npm install

Запуск

Только сервер (stdio)

npm run start

HTTP-сервер (порт 3001)

npm run start:http

HTTP-сервер + интерфейс React

npm run start:ui

Интерфейс доступен по адресу http://localhost:5173. HTTP-сервер MCP работает на http://localhost:3001/mcp.

Доступные инструменты MCP

Инструмент

Описание

ping

Проверка отклика сервера

get-github-user

Возвращает информацию о пользователе GitHub

get-weather

Возвращает погоду для заданных широты/долготы

Доступные ресурсы MCP

URI

Описание

github-user://{username}

Профиль пользователя GitHub

weather://{lat},{lon}

Погода для заданных GPS-координат

Архитектура

Проект следует принципам чистой архитектуры (Clean Architecture):

  • Domain — сущности и интерфейсы портов (без внешних зависимостей)

  • Application — варианты использования, управляющие бизнес-логикой

  • Infrastructure — HTTP-запросы к внешним API (GitHub, Open-Meteo)

  • Interface — предоставление доступа через протокол 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