MCP 服务器

Hello-MCP 🚀

一个简单的带有客户端和服务器的 MCP 演示

Cookie-HOO

开发者工具

访问服务器

README

Hello-MCP 🚀

中文文档 🇨🇳

一个简单的 MCP (模型控制协议) 客户端和服务端实现。帮助理解 MCP 协议是什么以及它是如何工作的。

本项目将 ✅:

教你 MCP 协议的本质
让你构建自己的 MCP 客户端和服务端
提供 MCP 实现的实践经验

本项目不会 ❌:

教你如何配置现有的 MCP 主机
实现通用的服务器功能（需要你自行探索）

特性 ✨

MCP 客户端

支持注册 MCP 服务器（SSE 和 stdio 两种方式）
交互式命令行聊天界面
支持 DeepSeek API 对话（在配置文件中配置 API 密钥）
流式响应输出

MCP 服务器

基于 FastMCP 的简单服务器（支持 SSE 和 stdio）
提供基本的路径工具（列出指定路径中的所有文件）
健康检查支持

演示

使用 List_Dir 工具获取文件并进行分析!

使用指南 📖

环境搭建

推荐使用 uv 进行项目管理

0. 克隆项目

git clone https://github.com/Cookie-HOO/hello-mcp.git
cd hello-mcp

1. 安装 uv

官方 uv 安装文档

macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (需要 PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 初始化项目依赖

uv venv  # 创建虚拟环境
uv sync  # 安装依赖
source ./.venv/bin/activate  # macOS: 激活虚拟环境
.\.venv\Scripts\activate     # Windows: 激活虚拟环境

3. 设置 DeepSeek API 密钥

目前仅支持 DeepSeek API - 申请地址: DeepSeek API Platform

cp ./config.example.yaml ./config.yaml
# 编辑以添加你的 DeepSeek API 密钥

4. 运行项目

# 方法 1: stdio (只需要显式启动客户端)
python -m hello_mcp.client2stdio --server-path ./hello_mcp/server.py

# 方法 2: SSE (需要显式启动服务端和客户端)
python -m hello_mcp.server --transport sse  # 以 SSE 模式启动服务器
python -m hello_mcp.client2sse --server-url http://127.0.0.1:8000  # 使用客户端注册 MCP 服务器

调试 MCP 服务器

uv run mcp dev hello_mcp/server.py

许可证 📜

MIT 许可证。详情请参见 LICENSE 文件。

👋 欢迎贡献! 欢迎提出问题和讨论。

MCP 使用指南 🛠️

1. 如何在日常工作中使用 MCP

找到一个满足你需求的 MCP 服务器主机
配置 MCP 服务器

MCP 主机参考列表:

客户端	资源	提示词	工具	采样	根目录	备注
5ire	❌	❌	✅	❌	❌	支持工具。
Apify MCP Tester	❌	❌	✅	❌	❌	支持工具
BeeAI Framework	❌	❌	✅	❌	❌	在 Agentic 工作流中支持工具。
Claude Code	❌	✅	✅	❌	❌	支持提示词和工具
Claude Desktop App	✅	✅	✅	❌	❌	支持工具、提示词和资源。
Cline	✅	❌	✅	❌	❌	支持工具和资源。
Continue	✅	✅	✅	❌	❌	支持工具、提示词和资源。
Copilot-MCP	✅	❌	✅	❌	❌	支持工具和资源。
Cursor	❌	❌	✅	❌	❌	支持工具。

2. 如何找到 MCP 工具

资源	推荐度
Smithery - Model Context Protocol Registry	🌟🌟🌟
https://github.com/punkpeye/awesome-mcp-servers	🌟🌟🌟
https://github.com/modelcontextprotocol/servers	🌟🌟🌟
List of all MCP Servers (42) \| Portkey	🌟🌟
https://cursor.directory/mcp	🌟🌟
Open-Source MCP servers \| Glama	🌟🌟
https://mcp.so/	🌟🌟
https://www.pulsemcp.com/servers	🌟🌟
Awesome MCP Servers	🌟🌟