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

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

πŸš€ 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
Advertise