feat(mcp): 每 IP 每日 5 次调用限流 + 教程更新限流说明

- _AuthMiddleware 新增 POST /mcp 按客户端 IP 日配额(X-Forwarded-For 优先,UTC+8 日期键,内存存储重启清零,env MCP_DAILY_LIMIT 默认 5)
- 超限返回 429 + Retry-After: 86400,限流只计 /mcp POST,/health /out/* 不受限
- mcp-guide.md 端点小节新增限流规则 + 常见问题第 9 条 429 排查
- 实测:前 5 次放行、第 6 次 429
This commit is contained in:
jinghui committed 2026-11-14 11:03:20 +08:00
1 parent 85d87f5db5
commit a85f7b7bbc
2 files changed
+99 -21

No files matched your search

+93 -21
View File
@@ -843,12 +843,53 @@ class _AuthMiddleware:
- /health 监控探针(nginx /mcp-health 转发,无法附带鉴权头)
- /out/* 工具产物下载直链(zip/mp3 交人浏览器点开,无法附带鉴权头)
其余路径(含 MCP 协议端点 /mcp 与全部未知路径)必须携带
Authorization: Bearer <MCP_AUTH_TOKEN>。
Authorization: Bearer ***
额外:对 POST /mcp 按客户端 IP 做每日调用上限(默认 5 次/天/IP,env MCP_DAILY_LIMIT 可调),
超限返回 429 Too Many Requests。
"""
OPEN_EXACT = ("/health",)
OPEN_PREFIX = ("/out/",)
# ---- 每 IP 每日调用计数(内存,容器重启清零;按 UTC+8 日期键重置)
DAILY_LIMIT = int(os.getenv("MCP_DAILY_LIMIT", "5"))
_rate_lock = None # 延迟初始化(事件循环启动后)
_rate_store: dict = {}
@classmethod
def _get_lock(cls):
import asyncio
if cls._rate_lock is None:
cls._rate_lock = asyncio.Lock()
return cls._rate_lock
@classmethod
async def _check_rate(cls, ip: str) -> tuple[bool, int]:
"""返回 (allowed, used_count_after)。超限返回 (False, current_count)。"""
import asyncio
lock = cls._get_lock()
from datetime import datetime, timezone, timedelta
today = (datetime.now(timezone(timedelta(hours=8))).date().isoformat())
async with lock:
entry = cls._rate_store.setdefault(ip, {})
# 清理旧日期键
for d in [k for k in entry if k != today]:
del entry[d]
used = entry.get(today, 0)
if used >= cls.DAILY_LIMIT:
return False, used
entry[today] = used + 1
return True, entry[today]
@staticmethod
def _client_ip(scope) -> str:
headers = {k.decode("latin-1").lower(): v.decode("latin-1") for k, v in scope.get("headers", [])}
xff = headers.get("x-forwarded-for", "")
if xff:
return xff.split(",")[0].strip()
client = scope.get("client")
return client[0] if client else "unknown"
def __init__(self, app):
self.app = app
@@ -858,6 +899,7 @@ class _AuthMiddleware:
return
path = scope.get("path", "")
if path in self.OPEN_EXACT or path.startswith(self.OPEN_PREFIX):
await self.app(scope, receive, send)
return
@@ -869,28 +911,58 @@ class _AuthMiddleware:
and got.startswith("Bearer ")
and hmac.compare_digest(got[7:].strip(), AUTH_TOKEN) # 恒定时间比较,防时序侧信道
)
if authorized:
await self.app(scope, receive, send)
if not authorized:
detail = (
"MCP_AUTH_TOKEN not configured on server (fail-closed)"
if not AUTH_TOKEN
else "missing or invalid bearer token"
)
body = json.dumps({"ok": False, "error": "unauthorized", "detail": detail}, ensure_ascii=False).encode()
await send(
{
"type": "http.response.start",
"status": 401,
"headers": [
(b"content-type", b"application/json"),
(b"content-length", str(len(body)).encode("ascii")),
(b"www-authenticate", b'Bearer realm="unicut-mcp", charset="UTF-8"'),
],
}
)
await send({"type": "http.response.body", "body": body})
return
detail = (
"MCP_AUTH_TOKEN not configured on server (fail-closed)"
if not AUTH_TOKEN
else "missing or invalid bearer token"
)
body = json.dumps({"ok": False, "error": "unauthorized", "detail": detail}, ensure_ascii=False).encode()
await send(
{
"type": "http.response.start",
"status": 401,
"headers": [
(b"content-type", b"application/json"),
(b"content-length", str(len(body)).encode("ascii")),
(b"www-authenticate", b'Bearer realm="unicut-mcp", charset="UTF-8"'),
],
}
)
await send({"type": "http.response.body", "body": body})
# ---- 每 IP 每日调用限流(仅 MCP 协议端点 /mcp 的 POST 计数)
if path in ("/mcp", "/mcp/") and scope.get("method", "GET").upper() == "POST":
ip = self._client_ip(scope)
allowed, used = await self._check_rate(ip)
if not allowed:
body = json.dumps(
{
"ok": False,
"error": "rate_limited",
"detail": f"该 IP 今日 MCP 调用已达上限({self.DAILY_LIMIT} 次/天),明日 00:00 重置",
"limit": self.DAILY_LIMIT,
"used": used,
"ip": ip,
},
ensure_ascii=False,
).encode()
await send(
{
"type": "http.response.start",
"status": 429,
"headers": [
(b"content-type", b"application/json"),
(b"content-length", str(len(body)).encode("ascii")),
(b"retry-after", b"86400"),
],
}
)
await send({"type": "http.response.body", "body": body})
return
await self.app(scope, receive, send)
if __name__ == "__main__":
+6
View File
@@ -29,6 +29,9 @@
- 令牌错误或没带 → 返回 `401 {"error":"unauthorized"}`,客户端里表现为「连接失败 / 401」
- **健康检查**:`https://cut.88531.cn/mcp-health`(返回容器健康状态 JSON)
- ⚠ `/mcp/health` **不是**端点——它会被前端回退成首页 HTML,别拿它测
- **限流**:每个客户端 IP 每天最多调用 **5 次**(按北京时间 00:00 重置,`env MCP_DAILY_LIMIT` 可调)——这是为了防止被刷爆;超限返回 `429 {"error":"rate_limited"}`,响应头带 `Retry-After: 86400`,等次日即可恢复
- 限流只计 **POST /mcp**(真正的工具调用),`/mcp-health`、`/mcp-out/*` 下载链接不受限
- 限流按 IP 识别(优先 `X-Forwarded-For`,反代场景下仍按真实客户端 IP 计);容器重启清零计数
## 三、接入你的 AI 客户端(四选一)
@@ -226,6 +229,9 @@ docker compose up -d --build unicut-mcp
**8. AI 说「找不到 unicut 这组工具」?**
客户端没加载成功:确认配置文件路径、URL、令牌后**重启客户端**;命令行客户端可用第六节 curl 先验证服务本身是通的。
**9. 调用提示 `429 rate_limited`(每天每 IP 5 次上限)?**
服务端对每个客户端 IP 每天最多放行 5 次 MCP 调用(按北京时间 00:00 重置)。超限后等次日再试,或让站点管理员调高 `MCP_DAILY_LIMIT` 环境变量并重建容器。注意 `/mcp-health` 与下载链接不受限。
## 九、相关链接
- [AI 一键出片新手教程](/article/about) —— 站内四步出片的完整操作