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

前置要求

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 installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

basic-mcp

basic-mcp

项目结构

前置要求

安装

启动

仅服务器 (stdio)

HTTP 服务器 (端口 3001)

HTTP 服务器 + React 界面

可用的 MCP 工具

可用的 MCP 资源

架构

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API