loading…
Search for a command to run...
loading…
A demonstration Model Context Protocol server that provides a configurable 'Hello World' tool with multi-language support and input validation. It supports both
A demonstration Model Context Protocol server that provides a configurable 'Hello World' tool with multi-language support and input validation. It supports both local stdio and remote HTTP deployment via Docker, facilitating testing and integration with platforms like Cursor and Manus.
一个简单的 Model Context Protocol (MCP) 服务器实现，提供 Hello World 功能演示。
适用于本地开发和 Cursor 集成：
# 1. 安装依赖
pip install -r requirements.txt
# 2. 验证安装
python mcp_server.py
适用于远程部署和 Manus 注册：
# 1. 安装依赖
pip install -r requirements.txt
# 2. 启动HTTP服务器
python mcp_server_http.py
# 服务器将在 http://0.0.0.0:8000 启动
一个简单的问候工具，支持以下参数：
name (string, 可选): 要问候的名字
language (string, 可选): 问候语言
count (integer, 可选): 重复次数
{
"name": "hello_world",
"arguments": {
"name": "张三",
"language": "zh",
"count": 3
}
}
输出：
1. 你好，张三！
2. 你好，张三！
3. 你好，张三！
[元数据: {"language": "zh", "name": "张三", "count": 3}]
{
"mcpServers": {
"hello-world": {
"command": "python",
"args": [
"C:\\work\\backend\\python-mcp\\mcp_server.py"
],
"env": {}
}
}
}
注意: 请将路径替换为你的实际项目路径。
在 Cursor 的配置文件中设置：
{
"mcpServers": {
"hello-world": {
"command": "python",
"args": [
"mcp_server.py"
],
"cwd": "C:\\work\\backend\\python-mcp",
"env": {
"PYTHONPATH": "C:\\work\\backend\\python-mcp"
}
}
}
}
如果你使用虚拟环境：
{
"mcpServers": {
"hello-world": {
"command": "C:\\work\\backend\\python-mcp\\venv\\Scripts\\python.exe",
"args": [
"C:\\work\\backend\\python-mcp\\mcp_server.py"
],
"env": {}
}
}
}
注册成功后，你可以在 Cursor 中：
# 启动服务
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down
# 构建镜像
docker build -t hello-world-mcp:latest .
# 运行容器
docker run -d \
--name hello-world-mcp \
-p 8000:8000 \
--restart unless-stopped \
hello-world-mcp:latest
# 赋予执行权限（Linux/Mac）
chmod +x deploy.sh
# 执行部署
./deploy.sh
# 设置环境变量
export HOST=0.0.0.0
export PORT=8000
# 启动服务器
python mcp_server_http.py
# 1. SSH连接到服务器
ssh [email protected]
# 2. 安装依赖
sudo apt update
sudo apt install python3 python3-pip docker.io docker-compose
# 3. 克隆项目
git clone <your-repo-url>
cd python-mcp
# 4. 使用Docker部署
docker-compose up -d
创建 /etc/nginx/sites-available/mcp-server:
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
启用配置并重启 Nginx:
sudo ln -s /etc/nginx/sites-available/mcp-server /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
配置 SSL 证书（使用 Let's Encrypt）:
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
部署成功后，访问以下端点验证：
http://your-server:8000/healthhttp://your-server:8000/http://your-server:8000/toolshttp://your-server:8000/mcpManus 是一个 MCP 服务器管理平台，允许你将自定义 MCP 服务器注册到平台上供 Agent 使用。
确保服务器可访问：
获取服务器 URL：
https://your-domain.com 或 https://your-ip:8000https://your-domain.com/mcp登录 Manus 控制台
导航到集成设置
添加自定义 MCP 服务器
填写服务器信息
https://your-domain.com/mcp
测试连接
保存配置
在 Manus 中添加服务器时的配置示例：
{
"name": "Hello World MCP",
"url": "https://your-domain.com/mcp",
"auth": {
"type": "none" // 或 "api_key", "bearer", "oauth"
}
}
注册成功后：
检查工具列表
测试工具调用
hello_world 工具查看日志
在生产环境中部署时，建议：
启用 HTTPS：
添加身份验证：
设置速率限制：
监控和日志：
问题1: Manus 无法连接到服务器
解决方案：
curl https://your-domain.com/health问题2: 工具列表获取失败
解决方案：
/tools 端点是否正常: curl https://your-domain.com/tools问题3: 工具调用失败
解决方案：
/mcpname 参数:
language 参数:
count 参数:
python-mcp/
├── mcp_server.py # MCP服务器主文件（stdio模式，用于本地）
├── mcp_server_http.py # MCP服务器HTTP版本（用于远程部署）
├── requirements.txt # Python依赖
├── Dockerfile # Docker镜像构建文件
├── docker-compose.yml # Docker Compose配置
├── deploy.sh # 快速部署脚本
├── test_server.py # 测试脚本
├── config.example.json # 配置文件示例
└── README.md # 说明文档
你可以使用 MCP 客户端工具测试服务器：
# 确保服务器可以正常启动
python mcp_server.py
解决方案: 确保已安装所有依赖
pip install -r requirements.txt
解决方案:
解决方案:
MIT License
欢迎提交 Issue 和 Pull Request！
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"mcp-hello-world-server": {
"command": "npx",
"args": []
}
}
}