Advertise
MCP.so
Sign In

Hello-MCP Server

@Cookie-HOO

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

Cookie-HOO

About Hello-MCP Server

A Simple MCP Demo With Client & Server

#mcp#client-server#protocol

Hello-MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hello-mcp": {
      "command": "uv",
      "args": [
        "venv",
        "#",
        "Create",
        "virtual",
        "environment"
      ]
    }
  }
}

Hello-MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Hello-MCP πŸš€?

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.

How to use Hello-MCP πŸš€?

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.

Key features of Hello-MCP πŸš€

  • 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

Use cases of Hello-MCP πŸš€

  • Learning the MCP protocol by building your own client and server
  • Gaining hands-on experience with MCP tool registration and invocation
  • Debugging MCP servers using the built-in MCP Inspector
  • Experimenting with MCP in daily AI workflows (e.g., with Claude Desktop or Cursor)
  • Extending the server with custom tools (by adding functions with the @tool decorator)

Frequently asked questions

1

What problems does MCP solve?

MCP standardizes AI model interaction protocols, provides unified tool calling specifications, simplifies complex AI system integration, and enables modular, reusable model capabilities.

2

How do I set up the DeepSeek API key?

Copy `config.example.yaml` to `config.yaml` and fill in your DeepSeek API key (obtained from https://platform.deepseek.com/api_keys). Ensure no extra spaces or quotes around the key.

3

What if the port is already in use when starting the server?

Use `lsof -i :8000` to find the process using the port, terminate it, or change the server port and update the client registration URL accordingly.

4

How can I extend Hello-MCP with new tools?

Add a new function in `server.py`, decorate it with `@tool`, define the input parameter schema, and test it by calling the client.

5

What are the runtime requirements?

Python 3, `uv` for project management, and a DeepSeek API key (currently the only supported AI provider). No additional MCP hosts are required; the server runs as a standalone Python process.

Comments

More Other MCP servers

πŸš€ Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise