Hello-MCP π
About
Hello-MCP π is a simple implementation of an MCP (Model Control Protocol) client and server. It helps developers understand what the MCP protocol is and how it works by providing hands-on experience in building and using both client and server components.
Details
- Author
- Cookie-HOO
- Downloads
- 339
- Categories
- Other
Jump to
- Supports registering MCP servers via SSE and stdio transports
- Interactive command-line chat interface
- Integrates with DeepSeek API (configurable API key)
- Streamed response output
- Simple server built on FastMCP with a path utility tool
- Health check endpoint on the server
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hello-MCP πCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install uv (e.g., via curl -LsSf https://astral.sh/uv/install.sh | sh on macOS), create a virtual environment (uv venv), install dependencies (uv sync), and activate it. Configure your DeepSeek API key in config.yaml (copy from config.example.yaml). Run the client in stdio mode with python -m hello_mcp.client2stdio --server-path ./hello_mcp/server.py or in SSE mode by first starting the server (python -m hello_mcp.server --transport sse) then the client (python -m hello_mcp.client2sse --server-url http://127.0.0.1:8000). Debug the server using uv run mcp dev hello_mcp/server.py.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hello-mcp \ud83d\ude80": {
"hello-mcp": {
"command": "uv",
"args": [
"venv",
"#",
"Create",
"virtual",
"environment"
]
}
}
}
}McpServers
{
"hello-mcp": {
"command": "uv",
"args": [
"venv",
"#",
"Create",
"virtual",
"environment"
]
}
}Hello-MCP π
---
δΈζζζ‘£ π¨π³
A simple implementation of MCP (Model Control Protocol) client and server.
Helps understand what MCP protocol is and how it works.
This project will β
:
- Teach you the essence of MCP protocol
- Let you build your own MCP Client and Server
- Provide hands-on experience with MCP implementation
This project won't β:
- Teach you how to configure existing MCP Hosts
- Implement generic server functionality (requires your own exploration)
Features β¨
MCP Client
- Supports registering MCP Server (both SSE and stdio methods) - Interactive command line chat interface - Supports DeepSeek API conversations (configure API key in config file) - Streamed response outputMCP Server
- Simple server based on FastMCP (supports both SSE and stdio) - Provides a basic path utility (lists all files in specified path) - Health check supportDEMO
Use List_Dir Tool to get files and analysis!
Usage Guide π
Environment Setup
> Recommended to use uv for project management
0. Clone the project
git clone https://github.com/Cookie-HOO/hello-mcp.git
cd hello-mcp
1. Install uv
macOS:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (requires PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2. Initialize project dependencies
uv venv # Create virtual environment
uv sync # Install dependencies
source ./.venv/bin/activate # macOS: activate virtual environment
.\.venv\Scripts\activate # Windows: activate virtual environment
3. Set up DeepSeek API key
Currently only supports DeepSeek API - apply at: DeepSeek API Platform```bash
cp ./config.example.yaml ./config.yaml
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
