Hello-MCP Server

@Cookie-HOO

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

Cookie-HOO

关于 Hello-MCP Server

A Simple MCP Demo With Client & Server

#mcp #client-server #protocol

Hello-MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Hello-MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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)

常见问题

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.

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.

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.

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.

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.

其他分类下的更多 MCP 服务器

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.