Skip to main content
Glama
deenesfrjakoruzh
tchoupoGuy

basic-mcp

by tchoupoGuy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

basic-mcp

GitHub 사용자 및 날씨 관련 도구와 리소스를 제공하는 React 인터페이스 기반의 MCP(Model Context Protocol) 서버입니다.

프로젝트 구조

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

Related MCP server: Weather MCP

사전 요구 사항

  • 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 — 외부 API(GitHub, Open-Meteo)에 대한 HTTP 호출

  • Interface — MCP 프로토콜을 통한 노출

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Server

    Nawaf-TBE
    A
    license
    Not graded
    quality
    D
    maintenance
    A Node.js/TypeScript server implementing the Model Context Protocol that provides integrations with GitHub and Notion, allowing automated workflow between these platforms via API endpoints.
    1,020 npm
    MIT

  • Weather MCP

    LiuKeTong713
    F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables natural language weather queries for global cities, integrating with OpenWeather API to provide real-time weather information in an easy-to-read format.
    1
    -

  • Weather MCP Server

    dbalencar
    F
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that interfaces with OpenWeatherMap API to provide real-time weather information and forecasts for cities worldwide.
    -

  • Weather MCP Server

    theshyPika
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides weather information using the Open-Meteo API, allowing users to get current weather for specific cities and retrieve weather data for date ranges.
    Apache 2.0