Skip to main content
Glama
deenesfrjakoruzh
tchoupoGuy

basic-mcp

by tchoupoGuy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

basic-mcp

一个带有 React 界面的 MCP (Model Context Protocol) 服务器，提供围绕 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

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 访问。 MCP HTTP 服务器监听 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