Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

decision-mind

MCP.Pizza Chef: rmrf2020

decision-mind is a demonstration MCP server project implemented in Python 3.10+, designed to showcase the Model Context Protocol's capabilities. It features web content fetching and parsing, system information monitoring, and real-time server-sent events (SSE) communication. The server supports resource management and tool execution, enabling dynamic and interactive client-server communication. It uses popular libraries such as httpx for HTTP requests, beautifulsoup4 for HTML parsing, uvicorn for ASGI server hosting, and psutil for system monitoring. decision-mind serves as a practical example for developers looking to implement MCP servers with real-time data streaming and protocol compliance.

Use This MCP server To

Fetch and parse web content for real-time data Monitor system information like CPU and memory usage Stream real-time events to MCP clients via SSE Demonstrate MCP protocol client-server communication Manage resources and execute tools dynamically

README

decision-mind

A demonstration project implementing the Model Context Protocol (MCP), showcasing client-server communication with various functionalities including web content fetching and system monitoring.

Features

  • Web content fetching and parsing
  • System information monitoring
  • Real-time server-sent events (SSE) communication
  • MCP protocol implementation
  • Resource management and tool execution

Requirements

  • Python 3.10+
  • Dependencies (install via pip):
    • httpx
    • beautifulsoup4
    • uvicorn
    • psutil
    • mcp-sdk

Installation

  1. Clone the repository:
git clone https://github.com/rmrf2020/decision-mind.git
cd decision-mind
  1. Create and activate a virtual environment:
python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt

Usage

  1. Start the server:
python server.py

The server will start on http://localhost:8000

  1. In a separate terminal, run the client:
python client.py

The client will connect to the server and demonstrate various functionalities including:

  • Listing available resources
  • Reading greeting message
  • Fetching system information
  • Processing web content

Protocol Implementation

This project implements the Model Context Protocol (MCP), providing a framework for:

  • Server-Sent Events (SSE) based communication
  • Resource management
  • Tool execution
  • Client-server interaction

License

See the LICENSE file for details.

decision-mind FAQ

How do I install decision-mind dependencies?
Use Python 3.10+, create a virtual environment, then run 'pip install -r requirements.txt' to install required packages like httpx, beautifulsoup4, uvicorn, psutil, and mcp-sdk.
How do I start the decision-mind server?
After installation, run 'python server.py' to start the server on http://localhost:8000.
What Python version is required for decision-mind?
decision-mind requires Python 3.10 or higher for compatibility with its dependencies and features.
Does decision-mind support real-time communication?
Yes, it supports real-time server-sent events (SSE) to stream updates to MCP clients.
Can decision-mind fetch and parse web content?
Yes, it uses httpx and beautifulsoup4 to fetch and parse web pages dynamically.
Is decision-mind suitable for production use?
decision-mind is primarily a demo project for MCP protocol implementation and may require enhancements for production environments.
What libraries does decision-mind use for system monitoring?
It uses psutil to monitor system information such as CPU and memory usage.
How does decision-mind implement MCP protocol?
It implements MCP server-side logic to handle client requests, resource management, and tool execution following MCP specifications.