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 からアクセス可能です。 MCP HTTPサーバーは http://localhost:3001/mcp でリッスンします。

利用可能なMCPツール

ツール

説明

ping

サーバーの応答を確認する

get-github-user

GitHubユーザーの情報を取得する

get-weather

指定した緯度・経度の天気を取得する

利用可能なMCPリソース

URI

説明

github-user://{username}

ユーザーのGitHubプロファイル

weather://{lat},{lon}

GPS座標の天気

アーキテクチャ

本プロジェクトはクリーンアーキテクチャの原則に従っています：

  • 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