广告合作
MCP.so
登录

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)

常见问题

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.

评论

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

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

🚀 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
广告合作