基本MCP服务器(FastAPI)
一个微型MCP服务器 验证, 拼,以及 回声 工具——专为快速提交Puch AI黑客马拉松而设计。
端点
GET /mcp--清单(名称、版本、工具)POST /mcp/validate--如果令牌有效,则仅以E.164数字格式返回您的手机POST /mcp/run--执行工具(ping,echo)
环境变量
AUTH_TOKEN(必需) — 您的秘密持有人代币 (aka *devtoken*)PHONE_E164(必填)——你的手机就像919876543210(仅数字)PORT(渲染/Heroku)——由主机提供
快速入门(本地)
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
export AUTH_TOKEN=changeme
export PHONE_E164=919000000000
uvicorn app.main:app --reload部署(渲染)
- 创建一个 Web服务 来自此repo/zip。
- 运行时:Python 3.11+
- 启动命令:
uvicorn app.main:app --host 0.0.0.0 --port $PORT - 环境变量:
- AUTH_TOKEN=your-super-secret - PHONE_E164=919xxxxxxxxx (仅数字)
- 打开URL:
https://.onrender.com(应显示“ok”)
从WhatsApp连接(Puch)
在您的Puch黑客马拉松聊天中,发送:
/mcp connect https://.onrender.com/mcp your-super-secret成功后,您将收到一个共享链接,如 https://puch.ai/mcp/ --提交 ``.
测试终点
# Manifest
curl https://.onrender.com/mcp
# Validate (token in header)
curl -X POST https://.onrender.com/mcp/validate -H "Authorization: Bearer your-super-secret" -d '{}'
# Run ping
curl -X POST https://.onrender.com/mcp/run -H "Authorization: Bearer your-super-secret" -H "Content-Type: application/json" -d '{"tool":"ping","args":{}}'
# Run echo
curl -X POST https://.onrender.com/mcp/run -H "Authorization: Bearer your-super-secret" -H "Content-Type: application/json" -d '{"tool":"echo","args":{"text":"hello"}}'______________________________________________________________________
渲染蓝图(一次性设置)
- 将此项目推送到GitHub(或上传)。
- 渲染时: New → 蓝图 然后选择您的repo。
- 审查
render.yaml.部署后:
- 渲染自动生成 AUTH_TOKEN (您可以在仪表板中覆盖)。 - 集 PHONE_E164 只支持数字的电话(例如。, 919876543210).
如果创建Web服务(不是蓝图)
- 启动命令:
uvicorn app.main:app --host 0.0.0.0 --port $PORT - 添加环境变量:
- AUTH_TOKEN =你的秘密 - PHONE_E164 例如。, 919876543210
WhatsApp连接(Puch)
/mcp connect https://.onrender.com/mcp 成功后,您将收到一个共享链接,如 https://puch.ai/mcp/.
