MCP Servers

PC-health-checking-MCP

An AI-powered PC Health Assistant that uses MCP, LangChain, and Gemini to check CPU, memory, disk usage, and OS info through natural language queries.

README

🖥️ PC Health Checker Assistant using MCP

An AI-powered PC Health Assistant built using the Model Context Protocol (MCP), LangChain, and Google Gemini. Developed a MCP server from scratch using the official Python MCP SDK to enable AI-agent interaction with local system resources, demonstrating the complete MCP client-server architecture.

Quick Preview

Project Objective

The objective of this project is to demonstrate how an AI agent can communicate with a custom-built MCP Server to access operating system information through standardized tools.

This project serves as a beginner-friendly implementation of:

Model Context Protocol (MCP)
MCP Server
MCP Client
LangChain Agents
Gemini Tool Calling
AI + System Integration

Technology Stack

Category	Technology
Programming Language	Python 3.12
AI Framework	LangChain
LLM	Google Gemini 3,1 Flash Lite
Protocol	Model Context Protocol (MCP)
MCP SDK	Official MCP Python SDK
System Monitoring	psutil
OS Information	platform
Environment Variables	python-dotenv

Features

Check CPU Usage
Check Memory Usage
Check Disk Usage
Retrieve Operating System Information
Natural Language Interaction
Custom MCP Server built from scratch
LangChain Agent integrated with Gemini
Modular architecture

Project Architecture

                         User
                           │
                           ▼
                 Natural Language Query
                           │
                           ▼
                      main.py
                           │
                           ▼
                LangChain Agent
                           │
                           ▼
                  Google Gemini
                           │
          Chooses Appropriate Tool
                           │
                           ▼
               LangChain Tool Wrapper
                           │
                           ▼
                     MCP Client
                           │
═══════════════════════════════════════
          Model Context Protocol
═══════════════════════════════════════
                           │
                           ▼
                     MCP Server
                           │
                           ▼
                  System Tools
                           │
                           ▼
              psutil / platform
                           │
                           ▼
                  Operating System

Example Conversation

User

Show me the operating system information.

Assistant

Operating System : Linux

OS Version : 7.0.0-28-generic

Architecture : x86_64

CPU Cores : 2

Logical Processors : 4

Python Version : 3.12.3

Learning Outcomes

By completing this project I have understand:

What is Model Context Protocol (MCP)
How MCP Server works
How MCP Client communicates with an MCP Server
How LangChain integrates with MCP
How Gemini performs tool selection
Building AI agents with external tools
Designing modular AI architectures

Installation

Clone the Repository

git clone https://github.com/Parisa-Reza/PC-health-checking-MCP.git

cd PC-health-MCP

Create Virtual Environment

Linux

python3 -m venv venv

source venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Create Environment File

Create a file named

.env

Add your Gemini API key.

Running the Project

Run the application.

python main.py

Example:

You:

How much CPU am I using?

License

This project is intended for educational and learning purposes.

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured