AI导哈

MCP服务器工具

一个轻量级的MCP服务器，提供验证、ping和echo工具，适用于快速开发和Puch AI黑客马拉松提交。

  • by dhruv-garg07
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dhruv-garg07/basic-mcp-server-render

使用说明

基本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

部署（渲染）

  1. 创建一个 Web服务 来自此repo/zip。
  2. 运行时：Python 3.11+
  3. 启动命令： uvicorn app.main:app --host 0.0.0.0 --port $PORT
  4. 环境变量：
    • AUTH_TOKEN=your-super-secret
    • PHONE_E164=919xxxxxxxxx （仅数字）
  5. 打开URL： https://<your-app>.onrender.com （应显示“ok”）

从WhatsApp连接（Puch）

在您的Puch黑客马拉松聊天中，发送：

/mcp connect https://<your-app>.onrender.com/mcp your-super-secret

成功后，您将收到一个共享链接，如 https://puch.ai/mcp/<server_id> --提交 <server_id>.

测试终点

# Manifest
curl https://<your-app>.onrender.com/mcp

# Validate (token in header)
curl -X POST https://<your-app>.onrender.com/mcp/validate          -H "Authorization: Bearer your-super-secret" -d '{}'

# Run ping
curl -X POST https://<your-app>.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://<your-app>.onrender.com/mcp/run          -H "Authorization: Bearer your-super-secret"          -H "Content-Type: application/json"          -d '{"tool":"echo","args":{"text":"hello"}}'

渲染蓝图（一次性设置）

  1. 将此项目推送到GitHub（或上传）。
  2. 渲染时： New → 蓝图 然后选择您的repo。
  3. 审查 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://<your-app>.onrender.com/mcp <AUTH_TOKEN>

成功后，您将收到一个共享链接，如 https://puch.ai/mcp/<server_id>.

相关 MCP