feat(mcp): MCP 功能页 + 顶栏入口 + Admin 调用记录 + nginx 反代

- /mcp-connect 功能页:连接信息/令牌管理/接入后怎么使用(三步+13场景话术+排错)/工具清单/注意事项
- 已购授权机自动显示主令牌+配置自动带真实令牌(打开即复制即用);未授权显示购买引导
- 右上角 MCP 入口(Plug);Admin 左侧「MCP 调用」页(总览/排行/流水)
- nginx location ~ ^/mcp(/|\$) 边界反代(防吞 /mcp-connect SPA 路由)
- WIDE_TOOLS/locales/relay in-repo 副本同步
This commit is contained in:
3970260761 committed 2026-11-12 16:47:06 +08:00
1 parent 855378df2c
commit c75f2882f7
13 files changed
+1882 -5

No files matched your search

+5
View File
@@ -153,6 +153,7 @@ declare module '@vue/runtime-core' {
MacAddressLookup: typeof import('./src/tools/mac-address-lookup/mac-address-lookup.vue')['default']
MarkdownToHtml: typeof import('./src/tools/markdown-to-html/markdown-to-html.vue')['default']
MathEvaluator: typeof import('./src/tools/math-evaluator/math-evaluator.vue')['default']
McpConnect: typeof import('./src/tools/mcp-connect/McpConnect.vue')['default']
MenuBar: typeof import('./src/tools/html-wysiwyg-editor/editor/menu-bar.vue')['default']
MenuBarItem: typeof import('./src/tools/html-wysiwyg-editor/editor/menu-bar-item.vue')['default']
MenuIconItem: typeof import('./src/components/MenuIconItem.vue')['default']
@@ -163,6 +164,7 @@ declare module '@vue/runtime-core' {
NAlert: typeof import('naive-ui')['NAlert']
NavbarButtons: typeof import('./src/components/NavbarButtons.vue')['default']
NButton: typeof import('naive-ui')['NButton']
NCard: typeof import('naive-ui')['NCard']
NCheckbox: typeof import('naive-ui')['NCheckbox']
NCode: typeof import('naive-ui')['NCode']
NCollapseTransition: typeof import('naive-ui')['NCollapseTransition']
@@ -173,6 +175,7 @@ declare module '@vue/runtime-core' {
NDropdown: typeof import('naive-ui')['NDropdown']
NDynamicInput: typeof import('naive-ui')['NDynamicInput']
NEllipsis: typeof import('naive-ui')['NEllipsis']
NEmpty: typeof import('naive-ui')['NEmpty']
NForm: typeof import('naive-ui')['NForm']
NFormItem: typeof import('naive-ui')['NFormItem']
NGi: typeof import('naive-ui')['NGi']
@@ -201,6 +204,8 @@ declare module '@vue/runtime-core' {
NStatistic: typeof import('naive-ui')['NStatistic']
NSwitch: typeof import('naive-ui')['NSwitch']
NTable: typeof import('naive-ui')['NTable']
NTabPane: typeof import('naive-ui')['NTabPane']
NTabs: typeof import('naive-ui')['NTabs']
NTag: typeof import('naive-ui')['NTag']
NumeronymGenerator: typeof import('./src/tools/numeronym-generator/numeronym-generator.vue')['default']
OtpCodeGeneratorAndValidator: typeof import('./src/tools/otp-code-generator-and-validator/otp-code-generator-and-validator.vue')['default']
+1 -1
View File
@@ -13,7 +13,7 @@ COPY piper-models /app/piper-models
COPY ai-models/u2net.onnx /root/.u2net/u2net.onnx
COPY waifu2x/waifu2x-ncnn-vulkan-20220728-ubuntu /app/waifu2x
WORKDIR /app
COPY server.py video_ops.py audio_ops.py .
COPY server.py video_ops.py audio_ops.py mcp_ops.py .
ENV HF_HOME=/root/.cache/huggingface
EXPOSE 8091
CMD ["python", "server.py"]
+744
View File
@@ -0,0 +1,744 @@
"""MCP (Model Context Protocol) 接入模块 — IT-TOOLS-PRO 授权应用的 AI 调用入口。
设计(与 video_ops/audio_ops 同为 server.py 伴星模块):
- 令牌:MCP 令牌存 DATA_DIR/mcp_tokens.json,与本机机器码绑定;生成与每次调用都复验
query_authorized / 账号授权,卡密过期令牌即失效("购买卡密才能调用")。
- 协议端点:POST /mcp —— MCP Streamable HTTP(JSON-RPC 2.0,无会话状态)。
initialize / tools/list 免鉴权(让客户端先发现工具),tools/call 必须 Bearer 令牌。
- 13 个工具经本机 loopback http://127.0.0.1:8091 直调 relay 自身端点(完整走
check() 授权 + log_usage() 统计),OCR 直打宿主 rapidocr:5000。
- 文件类结果落 DATA_DIR/mcp_files/,响应里返回可下载 URL(GET /mcp/file/<name>,同令牌鉴权)。
- 每次 tools/call 记 mcp_usage 表(令牌尾号/机器/工具/耗时/成败),供后台「MCP 调用」页查询。
"""
import json
import os
import re
import secrets
import sqlite3
import time
import urllib.error
import urllib.parse
import urllib.request
import uuid
# ---- 由 server.py 启动时注入(避免循环 import) ----
_CTX = {
"data_dir": "/app/data",
"usage_db": "/app/data/usage.db",
"query_authorized": lambda machine: False,
"account_ok": lambda machine: False,
"machine_ok": lambda m: bool(re.match(r"^\d{13,20}$", m)),
"public_base": "", # 空则按请求 Host 推断
}
def setup(**kw):
_CTX.update({k: v for k, v in kw.items() if v is not None})
_ensure_table()
def _tokens_file():
return os.path.join(_CTX["data_dir"], "mcp_tokens.json")
def _files_dir():
d = os.path.join(_CTX["data_dir"], "mcp_files")
os.makedirs(d, exist_ok=True)
return d
def _ensure_table():
try:
conn = sqlite3.connect(_CTX["usage_db"])
conn.execute("CREATE TABLE IF NOT EXISTS mcp_usage ("
"id INTEGER PRIMARY KEY AUTOINCREMENT, token_tail TEXT, machine TEXT, "
"tool TEXT, ok INTEGER, err TEXT, dur_ms INTEGER, at REAL)")
conn.commit()
conn.close()
except Exception:
pass
def log_mcp(token_tail: str, machine: str, tool: str, ok: bool, err: str, dur_ms: int):
try:
conn = sqlite3.connect(_CTX["usage_db"])
conn.execute("INSERT INTO mcp_usage (token_tail, machine, tool, ok, err, dur_ms, at) "
"VALUES (?,?,?,?,?,?,?)",
(token_tail, machine, tool, 1 if ok else 0, (err or "")[:400], int(dur_ms), time.time()))
conn.commit()
conn.close()
except Exception:
pass
def mcp_usage_query(days: int = 7) -> dict:
since = time.time() - days * 86400
conn = sqlite3.connect(_CTX["usage_db"])
rows = conn.execute(
"SELECT token_tail, machine, tool, ok, err, dur_ms, at FROM mcp_usage "
"WHERE at>? ORDER BY at DESC LIMIT 300", (since,)).fetchall()
by_tool = conn.execute(
"SELECT tool, COUNT(*), SUM(ok) FROM mcp_usage WHERE at>? GROUP BY tool ORDER BY COUNT(*) DESC",
(since,)).fetchall()
total = conn.execute("SELECT COUNT(*), SUM(ok) FROM mcp_usage WHERE at>?", (since,)).fetchone()
conn.close()
return {
"days": days,
"total": int(total[0] or 0),
"ok_total": int(total[1] or 0),
"by_tool": [{"tool": t, "count": int(c), "ok": int(o or 0)} for t, c, o in by_tool],
"rows": [{"token_tail": r[0], "machine": r[1], "tool": r[2], "ok": bool(r[3]),
"err": r[4] or "", "dur_ms": int(r[5] or 0), "at": int(r[6] or 0)} for r in rows],
}
# ---------------------------------------------------------------- 令牌管理
def _load_tokens() -> list:
try:
with open(_tokens_file(), "r", encoding="utf-8") as f:
data = json.load(f)
return data if isinstance(data, list) else []
except Exception:
return []
def _save_tokens(items: list):
tmp = _tokens_file() + ".tmp"
with open(tmp, "w", encoding="utf-8") as f:
json.dump(items, f, ensure_ascii=False, indent=1)
os.replace(tmp, _tokens_file())
def _authorized(machine: str) -> bool:
if not machine or not _CTX["machine_ok"](machine):
return False
try:
return bool(_CTX["query_authorized"](machine)) or bool(_CTX["account_ok"](machine))
except Exception:
return False
def _bearer(handler) -> str:
auth = handler.headers.get("Authorization", "") or ""
if auth.lower().startswith("bearer "):
return auth[7:].strip()
return (handler.headers.get("X-MCP-Token", "") or "").strip()
def _find_token(tok: str):
if not tok:
return None
for it in _load_tokens():
if it.get("token") == tok:
return it
return None
def tokens_api(method: str, payload: dict, qs: dict) -> tuple[int, dict]:
"""令牌管理:GET /mcp/tokens、POST /mcp/tokens(生成)、POST /mcp/tokens/delete。"""
machine = (payload.get("machine_id") or payload.get("machine")
or (qs.get("machine_id") or qs.get("machine") or [""])[0] or "").strip()
if not _authorized(machine):
return 403, {"code": 403, "message": "本设备尚未授权:购买卡密并激活后才能生成 MCP 令牌"}
items = _load_tokens()
if method == "GET":
mine = [it for it in items if it.get("machine") == machine]
return 200, {"code": 200, "message": "ok",
"data": {"tokens": mine, "count": len(mine), "authorized": True}}
if method == "POST" and payload.get("action") == "delete":
tok = payload.get("token") or ""
kept = [it for it in items if not (it.get("token") == tok and it.get("machine") == machine)]
if len(kept) != len(items):
_save_tokens(kept)
return 200, {"code": 200, "message": "已删除", "data": {"tokens": [i for i in kept if i.get("machine") == machine]}}
return 404, {"code": 404, "message": "令牌不存在"}
# 生成
mine = [it for it in items if it.get("machine") == machine]
if len(mine) >= 10:
return 400, {"code": 400, "message": "每台设备最多 10 个 MCP 令牌,请先删除不用的"}
note = (payload.get("note") or "").strip()[:40]
rec = {
"token": "mcpt_" + secrets.token_hex(24),
"machine": machine,
"note": note or "MCP 客户端",
"created": int(time.time()),
"last_used": 0,
"calls": 0,
}
items.append(rec)
_save_tokens(items)
return 200, {"code": 200, "message": "ok", "data": {"token": rec["token"], "record": rec}}
def _touch_token(tok: str):
items = _load_tokens()
changed = False
for it in items:
if it.get("token") == tok:
it["last_used"] = int(time.time())
it["calls"] = int(it.get("calls") or 0) + 1
changed = True
break
if changed:
try:
_save_tokens(items)
except Exception:
pass
# ---------------------------------------------------------------- http 内调
_LOOPBACK = "http://127.0.0.1:8091"
_OCR_URL = "http://host.docker.internal:5000/ocr"
def _req(base: str, method: str, path: str, headers: dict, body=None, timeout: int = 600):
h = {"User-Agent": "ittools-mcp/1.0"}
if headers:
h.update(headers)
url = base + path
req = urllib.request.Request(url, data=body, headers=h, method=method)
try:
with urllib.request.urlopen(req, timeout=timeout) as r:
return r.status, dict(r.headers), r.read()
except urllib.error.HTTPError as e:
return e.code, dict(e.headers), e.read()
def _hdr(machine: str, tool: str, ct: str = "") -> dict:
h = {"X-Machine-Id": machine, "X-Tool": tool}
if ct:
h["Content-Type"] = ct
return h
def _check(status, raw):
if status == 403:
raise RuntimeError("授权校验未通过(403):设备授权缺失或已过期")
if status >= 400:
raise RuntimeError(f"HTTP {status}: {raw.decode('utf-8', 'ignore')[:300]}")
return raw
def _json_api(status, raw):
_check(status, raw)
try:
j = json.loads(raw.decode("utf-8"))
except Exception:
return raw.decode("utf-8", "ignore")[:5000]
if isinstance(j, dict) and j.get("code") not in (None, 200, 0):
raise RuntimeError(j.get("message") or f"接口返回 code={j.get('code')}")
return j
def _multipart(fields, files):
boundary = uuid.uuid4().hex
out = bytearray()
for k, v in fields.items():
out += f"--{boundary}\r\nContent-Disposition: form-data; name=\"{k}\"\r\n\r\n{v}\r\n".encode()
for field, fname, data, ct in files:
out += (f"--{boundary}\r\nContent-Disposition: form-data; name=\"{field}\"; "
f"filename=\"{fname}\"\r\nContent-Type: {ct}\r\n\r\n").encode()
out += data + b"\r\n"
out += f"--{boundary}--\r\n".encode()
return bytes(out), f"multipart/form-data; boundary={boundary}"
def _mime(path: str) -> str:
ext = os.path.splitext(path)[1].lower()
return {
".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp",
".gif": "image/gif", ".pdf": "application/pdf", ".mp3": "audio/mpeg", ".wav": "audio/wav",
".m4a": "audio/mp4", ".mp4": "video/mp4", ".mov": "video/quicktime", ".mkv": "video/x-matroska",
".avi": "video/x-msvideo", ".webm": "video/webm",
".doc": "application/msword",
".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
".xls": "application/vnd.ms-excel",
".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
".ppt": "application/vnd.ms-powerpoint",
".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
".txt": "text/plain", ".srt": "application/x-subrip", ".json": "application/json",
}.get(ext, "application/octet-stream")
def _save_file(data: bytes, name_hint: str, headers=None) -> dict:
name = name_hint
cd = (headers or {}).get("Content-Disposition") or ""
m = re.search(r"filename\*=UTF-8''([^;]+)", cd) or re.search(r'filename="([^"]+)"', cd)
if m:
name = urllib.parse.unquote(m.group(1))
safe = re.sub(r"[^\w.\-]+", "_", name)[-80:] or "result.bin"
if "." not in safe:
safe += ".bin"
fname = f"{time.strftime('%Y%m%d-%H%M%S')}-{uuid.uuid4().hex[:6]}-{safe}"
with open(os.path.join(_files_dir(), fname), "wb") as f:
f.write(data)
return {"file": fname, "name": safe, "bytes": len(data), "url": f"/mcp/file/{fname}"}
def _host_path(path: str) -> str:
"""AI 客户端(与宿主同机)传宿主绝对路径(/vol1/…),relay 容器内经 /:/hostfs 挂载可达。"""
if not path or not str(path).startswith("/"):
return path
if os.path.isfile(path):
return path
alt = "/hostfs" + path
if os.path.isfile(alt):
return alt
return path
def _read_file(path: str) -> bytes:
path = _host_path(path)
if not path or not os.path.isfile(path):
raise RuntimeError(f"文件不存在: {path}")
with open(path, "rb") as f:
return f.read()
def _ok(data):
return json.dumps({"ok": True, "data": data}, ensure_ascii=False, default=str)
def _err(e):
return json.dumps({"ok": False, "error": str(e)[:1500]}, ensure_ascii=False)
# ---------------------------------------------------------------- 13 个工具
def tool_translate_text(machine, text, source="auto", target="zh-CN"):
q = urllib.parse.urlencode({"client": "gtx", "sl": source, "tl": target, "dt": "t", "q": text})
status, _, raw = _req(_LOOPBACK, "GET", "/translate?" + q, _hdr(machine, "translator"), timeout=60)
j = json.loads(_check(status, raw).decode("utf-8"))
segs = j[0] if isinstance(j, list) and j else []
return _ok({"text": "".join(s[0] for s in segs if isinstance(s, list) and s and s[0])})
def tool_ocr(machine, path):
path = _host_path(path)
if path.lower().endswith(".pdf"):
pages = _pdf_pages(path)
result = []
for fn, data in pages:
body, ct = _multipart({}, [("image_file", fn, data, "image/jpeg")])
status, _, raw = _req("http://host.docker.internal:5000", "POST", "/ocr",
_hdr(machine, "pdf-ocr", ct), body, timeout=120)
j = json.loads(_check(status, raw).decode("utf-8"))
lines = [{"text": j[k].get("rec_txt", ""), "score": j[k].get("score", 0)}
for k in sorted(j, key=lambda x: int(x)) if j[k].get("rec_txt")]
result.append({"page": fn, "lines": lines})
return _ok({"pages": len(result), "detail": result,
"text": "\n".join(l["text"] for p in result for l in p["lines"])})
data = _read_file(path)
body, ct = _multipart({}, [("image_file", os.path.basename(path), data, _mime(path))])
status, _, raw = _req("http://host.docker.internal:5000", "POST", "/ocr",
_hdr(machine, "image-ocr", ct), body, timeout=120)
j = json.loads(_check(status, raw).decode("utf-8"))
lines = [{"text": j[k].get("rec_txt", ""), "score": j[k].get("score", 0)}
for k in sorted(j, key=lambda x: int(x)) if j[k].get("rec_txt")]
return _ok({"lines": lines, "text": "\n".join(l["text"] for l in lines)})
def _pdf_pages(path, dpi=150):
try:
import subprocess
tmp = os.path.join(_files_dir(), f".pdf-{uuid.uuid4().hex[:8]}")
os.makedirs(tmp, exist_ok=True)
proc = subprocess.run(["pdftoppm", "-jpeg", "-r", str(dpi), path, os.path.join(tmp, "p")],
capture_output=True, timeout=120)
if proc.returncode == 0:
pages = []
for fn in sorted(os.listdir(tmp)):
if fn.endswith(".jpg"):
with open(os.path.join(tmp, fn), "rb") as f:
pages.append((fn, f.read()))
if pages:
return pages
except Exception:
pass
try:
import fitz
except ImportError:
raise RuntimeError("PDF 渲染组件缺失(需 pdftoppm 或 pymupdf)")
with open(path, "rb") as f:
data = f.read()
doc = fitz.open(stream=data, filetype="pdf")
return [(f"page-{i + 1}.jpg", p.get_pixmap(dpi=dpi).tobytes("jpg")) for i, p in enumerate(doc)]
def tool_translate_doc(machine, path, to="en"):
data = _read_file(path)
body, ct = _multipart({"to": to}, [("file", os.path.basename(path), data, _mime(path))])
status, _, raw = _req(_LOOPBACK, "POST", "/translate-doc", _hdr(machine, "translator", ct),
body, timeout=480)
j = _json_api(status, raw)
d = j.get("data") or {}
return _ok({"text": d.get("text"), "chars": d.get("chars"), "target": to})
def tool_tts(machine, text, voice="", rate="", pitch=""):
body = json.dumps({"text": text, "voice": voice, "rate": rate, "pitch": pitch}).encode()
status, hdrs, raw = _req(_LOOPBACK, "POST", "/tts", _hdr(machine, "audio-tools", "application/json"),
body, timeout=180)
_check(status, raw)
if raw[:1] in (b"{", b"["):
raise RuntimeError(json.loads(raw.decode("utf-8")).get("message") or "TTS 失败")
return _ok(_save_file(raw, "tts.mp3", hdrs))
def tool_speech_to_text(machine, path, language="auto"):
data = _read_file(path)
body, ct = _multipart({"language": language}, [("file", os.path.basename(path), data, _mime(path))])
status, _, raw = _req(_LOOPBACK, "POST", "/asr", _hdr(machine, "audio-tools", ct), body, timeout=300)
j = _json_api(status, raw)
d = j.get("data") or {}
return _ok({"text": d.get("text"), "language": d.get("language"), "segments": d.get("segments")})
def tool_extract_subtitle(machine, path, lang=""):
data = _read_file(path)
body, ct = _multipart({}, [("file", os.path.basename(path), data, _mime(path))])
status, _, raw = _req(_LOOPBACK, "POST", "/subtitle?lang=" + urllib.parse.quote(lang),
_hdr(machine, "video-tools", ct), body, timeout=600)
j = _json_api(status, raw)
d = j.get("data") or {}
return _ok({"segments": d.get("segments"), "language": d.get("language")})
_VIDEO_OPS = ("convert", "gif", "gif2video", "compress", "trim", "rotate", "flip",
"speed", "mute", "watermark", "unwatermark", "audio", "screenshot")
def tool_video_process(machine, path, op, options=None):
if op == "subtitle":
return tool_extract_subtitle(machine, path)
if op not in _VIDEO_OPS:
raise RuntimeError(f"op 须为 {'/'.join(_VIDEO_OPS)} 或 subtitle")
data = _read_file(path)
fields = {"op": op}
for k, v in (options or {}).items():
fields[k] = str(v)
body, ct = _multipart(fields, [("file", os.path.basename(path), data, _mime(path))])
status, hdrs, raw = _req(_LOOPBACK, "POST", "/video", _hdr(machine, "video-tools", ct), body, timeout=600)
_check(status, raw)
if raw[:1] in (b"{", b"["):
raise RuntimeError(json.loads(raw.decode("utf-8")).get("message") or "视频处理失败")
return _ok(_save_file(raw, f"{op}-out.bin", hdrs))
def tool_gen_image(machine, prompt, model="pollinations-flux", width=1024, height=1024):
body = json.dumps({"machine": machine, "prompt": prompt, "model": model,
"width": int(width), "height": int(height)}).encode()
status, _, raw = _req(_LOOPBACK, "POST", "/ai/gen-image",
_hdr(machine, "ai-gen", "application/json"), body, timeout=300)
j = _json_api(status, raw)
d = (j.get("data") or {}) if isinstance(j, dict) else {}
if d.get("b64"):
import base64
b64 = d["b64"].split(",", 1)[-1]
return _ok(_save_file(base64.b64decode(b64), "ai-gen.png"))
if d.get("url"):
req = urllib.request.Request(d["url"], headers={"User-Agent": "ittools-mcp/1.0"})
with urllib.request.urlopen(req, timeout=120) as r:
return _ok(_save_file(r.read(), "ai-gen.png", dict(r.headers)))
raise RuntimeError("接口未返回图片数据")
def tool_convert_doc(machine, path, format):
data = _read_file(path)
body, ct = _multipart({"format": format}, [("files", os.path.basename(path), data, _mime(path))])
status, hdrs, raw = _req(_LOOPBACK, "POST", "/convert", _hdr(machine, "doc-convert", ct),
body, timeout=300)
_check(status, raw)
if raw[:1] in (b"{", b"["):
raise RuntimeError(json.loads(raw.decode("utf-8")).get("message") or "格式转换失败")
return _ok(_save_file(raw, os.path.basename(path) + f".{format.lstrip('.')}", hdrs))
def _raw_image_op(machine, path, api_path, ct_override=None, timeout=300):
data = _read_file(path)
status, hdrs, raw = _req(_LOOPBACK, "POST", api_path,
_hdr(machine, "image-tools", ct_override or _mime(path)),
data, timeout=timeout)
_check(status, raw)
if raw[:1] in (b"{", b"["):
raise RuntimeError(json.loads(raw.decode("utf-8")).get("message") or "图片处理失败")
ext = ".png" if raw[:8] == b"\x89PNG\r\n\x1a\n" else (".jpg" if raw[:2] == b"\xff\xd8" else ".webp")
return _ok(_save_file(raw, "out" + ext, hdrs))
def tool_remove_bg(machine, path):
return _raw_image_op(machine, path, "/remove-bg", timeout=300)
def tool_upscale_image(machine, path, scale=2, noise=1):
if int(scale) not in (2, 4):
raise RuntimeError("scale 仅支持 2 或 4")
return _raw_image_op(machine, path, f"/upscale?scale={int(scale)}&noise={int(noise)}", timeout=400)
_COPY_SCENES = ("rewrite", "deaigc", "titles", "xhs", "moments")
def tool_copywriting(machine, text, scene="rewrite", model="mimo-v2.6-flash"):
if scene not in _COPY_SCENES:
raise RuntimeError(f"scene 须为 {'/'.join(_COPY_SCENES)}")
body = json.dumps({"machine": machine, "scene": scene, "text": text, "model": model}).encode()
status, _, raw = _req(_LOOPBACK, "POST", "/ai/copy", _hdr(machine, "", "application/json"),
body, timeout=180)
j = _json_api(status, raw)
d = j.get("data") if isinstance(j, dict) else j
if isinstance(d, dict) and (d.get("text") or d.get("reply")):
return _ok({"text": d.get("text") or d.get("reply")})
if isinstance(d, str):
return _ok({"text": d})
return _ok({"result": d})
def tool_vision_qa(machine, image_path, question="描述这张图片的内容"):
import base64
data = _read_file(image_path)
body = json.dumps({"machine": machine, "image": base64.b64encode(data).decode(),
"question": question}).encode()
status, _, raw = _req(_LOOPBACK, "POST", "/ai/vision", _hdr(machine, "image-tools", "application/json"),
body, timeout=180)
j = _json_api(status, raw)
d = j.get("data") if isinstance(j, dict) else j
if isinstance(d, dict) and (d.get("text") or d.get("answer") or d.get("reply")):
return _ok({"answer": d.get("text") or d.get("answer") or d.get("reply")})
if isinstance(d, str):
return _ok({"answer": d})
return _ok({"result": d})
# ---------------------------------------------------------------- 工具注册表
_S = {"type": "object"}
TOOLS = [
{"name": "translate_text", "fn": tool_translate_text,
"description": "翻译一段文本(谷歌引擎,多语言互译)。",
"inputSchema": {"type": "object", "properties": {
"text": {"type": "string"}, "source": {"type": "string", "default": "auto"},
"target": {"type": "string", "default": "zh-CN"}}, "required": ["text"]}},
{"name": "ocr", "fn": tool_ocr,
"description": "识别图片/PDF 中的文字,返回逐行文本与置信度(PDF 自动逐页)。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string", "description": "服务器可访问的文件路径或已上传文件名"}},
"required": ["path"]}},
{"name": "translate_doc", "fn": tool_translate_doc,
"description": "整篇文档翻译(docx/pdf 等 → 译文全文),耗时可达数分钟。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"},
"to": {"type": "string", "default": "en"}},
"required": ["path"]}},
{"name": "tts", "fn": tool_tts,
"description": "文字合成语音,返回 mp3 下载 URL。",
"inputSchema": {"type": "object", "properties": {"text": {"type": "string"},
"voice": {"type": "string"}, "rate": {"type": "string"},
"pitch": {"type": "string"}}, "required": ["text"]}},
{"name": "speech_to_text", "fn": tool_speech_to_text,
"description": "音频转文字(ASR),返回识别文本与时间分段。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"},
"language": {"type": "string", "default": "auto"}},
"required": ["path"]}},
{"name": "extract_subtitle", "fn": tool_extract_subtitle,
"description": "视频/音频 AI 字幕生成:输出带时间轴的识别分段。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"}, "lang": {"type": "string"}},
"required": ["path"]}},
{"name": "video_process", "fn": tool_video_process,
"description": "视频批处理:转码/压缩/裁剪/旋转/翻转/调速/消音/加去水印/提取音频/截图/GIF 等。",
"inputSchema": {"type": "object", "properties": {
"path": {"type": "string"}, "op": {"type": "string", "enum": list(_VIDEO_OPS) + ["subtitle"]},
"options": {"type": "object", "description": "按 op 传参:trim={start,end}; speed={speed}; rotate={angle}; flip={dir}; watermark={text}; unwatermark={x,y,w,h}; convert={format}; gif={fps,w,h}"}},
"required": ["path", "op"]}},
{"name": "gen_image", "fn": tool_gen_image,
"description": "AI 文生图,返回图片下载 URL。",
"inputSchema": {"type": "object", "properties": {"prompt": {"type": "string"},
"model": {"type": "string", "default": "pollinations-flux"},
"width": {"type": "integer", "default": 1024},
"height": {"type": "integer", "default": 1024}},
"required": ["prompt"]}},
{"name": "convert_doc", "fn": tool_convert_doc,
"description": "文档格式转换(pdf/docx/xlsx/pptx 互转等),返回结果下载 URL。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"},
"format": {"type": "string"}}, "required": ["path", "format"]}},
{"name": "remove_bg", "fn": tool_remove_bg,
"description": "图片抠图去背景,输出透明底 PNG 下载 URL。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}},
{"name": "upscale_image", "fn": tool_upscale_image,
"description": "图片超分辨率放大(2x/4x)并降噪。",
"inputSchema": {"type": "object", "properties": {"path": {"type": "string"},
"scale": {"type": "integer", "default": 2},
"noise": {"type": "integer", "default": 1}},
"required": ["path"]}},
{"name": "copywriting", "fn": tool_copywriting,
"description": "文案工具箱:改写/降AIGC率/爆款标题/小红书笔记/朋友圈文案。",
"inputSchema": {"type": "object", "properties": {
"text": {"type": "string"}, "scene": {"type": "string", "enum": list(_COPY_SCENES)},
"model": {"type": "string", "default": "mimo-v2.6-flash"}}, "required": ["text", "scene"]}},
{"name": "vision_qa", "fn": tool_vision_qa,
"description": "看图问答:描述图片内容/提取图中信息/判断图片状态。",
"inputSchema": {"type": "object", "properties": {"image_path": {"type": "string"},
"question": {"type": "string"}},
"required": ["image_path"]}},
]
TOOLS_MAP = {t["name"]: t for t in TOOLS}
def tools_schema() -> list:
return [{k: t[k] for k in ("name", "description", "inputSchema")} for t in TOOLS]
# ---------------------------------------------------------------- JSON-RPC
def _public_base(handler) -> str:
if _CTX.get("public_base"):
return _CTX["public_base"].rstrip("/")
host = handler.headers.get("Host", "") or "it.88531.cn"
# 带端口的内网访问走 http,否则公网 https
scheme = "http" if ":" in host else "https"
return f"{scheme}://{host}"
def _rpc_result(rid, result):
return {"jsonrpc": "2.0", "id": rid, "result": result}
def _rpc_error(rid, code, message):
return {"jsonrpc": "2.0", "id": rid, "error": {"code": code, "message": message}}
def _handle_rpc(req: dict, token_rec: dict | None, handler) -> dict | None:
"""处理单个 JSON-RPC 请求;notification 返回 None。"""
method = req.get("method")
rid = req.get("id")
params = req.get("params") or {}
if method in ("notifications/initialized", "notifications/cancelled", "notifications/roots/list_changed"):
return None
if rid is None and method and method.startswith("notifications/"):
return None
if method == "ping":
return _rpc_result(rid, {})
if method == "initialize":
return _rpc_result(rid, {
"protocolVersion": params.get("protocolVersion", "2025-06-18"),
"capabilities": {"tools": {}},
"serverInfo": {"name": "it-tools-pro", "version": "1.0.0",
"title": "IT-TOOLS-PRO 授权应用 MCP"},
"instructions": "本站 13 个授权工具的 MCP 入口。文件类入参传服务器可见的文件路径;"
"结果中的 url 字段为可下载地址(需同款 Bearer 令牌)。",
})
if method == "tools/list":
return _rpc_result(rid, {"tools": tools_schema()})
if method == "tools/call":
if not token_rec:
return _rpc_error(rid, -32001, "未授权:请在请求头携带 Authorization: Bearer <MCP令牌>(站内「MCP 接入」页购买卡密后生成)")
machine = token_rec.get("machine") or ""
if not _authorized(machine):
return _rpc_error(rid, -32001, "授权已失效:卡密过期或设备授权撤销,请重新激活")
name = params.get("name")
args = params.get("arguments") or {}
tool = TOOLS_MAP.get(name)
if not tool:
return _rpc_error(rid, -32602, f"unknown tool: {name}")
if name in ("ocr", "translate_doc", "tts", "speech_to_text", "extract_subtitle",
"video_process", "convert_doc", "remove_bg", "upscale_image", "vision_qa"):
# 文件类入参:允许直接传文件名(mcp_files 内已上传文件)或绝对路径
for key in ("path", "image_path"):
if key in args and args[key] and not os.path.isabs(str(args[key])):
cand = os.path.join(_files_dir(), os.path.basename(str(args[key])))
if os.path.isfile(cand):
args[key] = cand
t0 = time.time()
ok, err = True, ""
try:
text = tool["fn"](machine, **args)
except Exception as e: # noqa: BLE001
text, ok, err = _err(e), False, str(e)
dur = int((time.time() - t0) * 1000)
log_mcp((token_rec.get("token") or "")[-6:], machine, name, ok, err, dur)
_touch_token(token_rec.get("token") or "")
# 下载 URL 补全域前缀
try:
obj = json.loads(text)
base = _public_base(handler)
def _abs(o):
if isinstance(o, dict):
return {k: (base + v if k == "url" and isinstance(v, str) and v.startswith("/mcp/") else _abs(v))
for k, v in o.items()}
if isinstance(o, list):
return [_abs(x) for x in o]
return o
text = json.dumps(_abs(obj), ensure_ascii=False)
except Exception:
pass
return _rpc_result(rid, {"content": [{"type": "text", "text": text}], "isError": not ok})
return _rpc_error(rid, -32601, f"method not found: {method}")
def handle_post(handler) -> tuple[int, bytes, str]:
"""POST /mcp —— 返回 (status, body, content_type)。"""
try:
length = int(handler.headers.get("Content-Length") or 0)
except ValueError:
length = 0
raw = handler.rfile.read(length) if length else b"{}"
try:
payload = json.loads(raw.decode("utf-8") or "{}")
except Exception:
return 400, json.dumps({"jsonrpc": "2.0", "id": None,
"error": {"code": -32700, "message": "parse error"}},
ensure_ascii=False).encode(), "application/json"
tok = _bearer(handler)
token_rec = _find_token(tok)
# initialize/tools/list 免鉴权(发现能力),tools/call 必须有效令牌
requests = payload if isinstance(payload, list) else [payload]
needs_auth = any(isinstance(r, dict) and r.get("method") == "tools/call" for r in requests)
if needs_auth and not token_rec:
return 401, json.dumps({"error": "unauthorized",
"message": "缺少或无效的 MCP 令牌(Authorization: Bearer mcpt_…)"},
ensure_ascii=False).encode(), "application/json"
out = []
for r in requests:
if not isinstance(r, dict):
continue
resp = _handle_rpc(r, token_rec, handler)
if resp is not None:
out.append(resp)
if not out:
return 202, b"", "application/json"
body = out[0] if len(out) == 1 else out
return 200, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json"
def handle_get_file(handler, fname: str):
"""GET /mcp/file/<name> —— 令牌鉴权后提供结果文件下载。"""
tok = _bearer(handler)
if not _find_token(tok):
handler.send_response(401)
handler.send_header("Content-Type", "application/json")
handler.end_headers()
handler.wfile.write(b'{"error":"unauthorized"}')
return
safe = os.path.basename(fname)
path = os.path.join(_files_dir(), safe)
if not os.path.isfile(path):
handler.send_response(404)
handler.end_headers()
handler.wfile.write(b'{"error":"not found"}')
return
with open(path, "rb") as f:
data = f.read()
handler.send_response(200)
handler.send_header("Content-Type", "application/octet-stream")
handler.send_header("Content-Length", str(len(data)))
handler.send_header("Content-Disposition",
f'attachment; filename="{safe}"; filename*=UTF-8\'\'{urllib.parse.quote(safe)}')
handler.end_headers()
handler.wfile.write(data)
+368
View File
@@ -32,6 +32,8 @@ import zipfile
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from urllib import parse, request
import mcp_ops
UPSTREAM = "https://translate.googleapis.com/translate_a/single"
PROXY = os.environ.get("HTTPS_PROXY") or os.environ.get("https_proxy") or ""
TIMEOUT = float(os.environ.get("RELAY_TIMEOUT", "25"))
@@ -907,6 +909,80 @@ def log_usage(machine: str, tool: str):
pass
# ---- 前端工具使用上报(未登录访客也统计):10 分钟同机同工具去重 + 每 IP 限流防刷 ----
_USE_SEEN: dict = {} # "<machine|ip>|<tool>" -> last report ts
_USE_IP: dict = {} # ip -> [recent ts...]
_USE_LOCK = threading.Lock()
def usage_track(payload: dict, handler) -> tuple:
"""POST /usage:任意访客(含未登录)上报工具使用,落 usage.db。
10 分钟内同一机器+同一工具只计一次(防刷新刷量);每 IP 10 分钟上限 300 条。"""
tool = str(payload.get("tool") or "").strip()
if not tool or len(tool) > 64 or not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9\-_.]*", tool):
return 400, {"code": 400, "message": "无效 tool"}
machine = str(payload.get("machine_id") or "").strip()
if machine and not MACHINE_RE.match(machine):
machine = ""
try:
ip = (handler.headers.get("X-Real-IP") or "").strip() or handler.client_address[0]
except Exception:
ip = ""
now = time.time()
key = f"{machine or ip}|{tool}"
with _USE_LOCK:
if len(_USE_SEEN) > 20000: # 修剪过期键,防内存膨胀
for k in [k for k, t in _USE_SEEN.items() if now - t >= 600]:
_USE_SEEN.pop(k, None)
last = _USE_SEEN.get(key)
if last is not None and now - last < 600:
return 200, {"code": 200, "message": "ok", "data": {"dup": 1}}
recent = [t for t in _USE_IP.get(ip, []) if now - t < 600]
if len(recent) >= 300:
_USE_IP[ip] = recent
return 200, {"code": 200, "message": "ok", "data": {"capped": 1}}
recent.append(now)
_USE_IP[ip] = recent
_USE_SEEN[key] = now
log_usage(machine, tool)
return 200, {"code": 200, "message": "ok", "data": {"ok": 1}}
# ---- 在线统计:仅未登录访客,前端停留满 1 分钟才开始心跳 ----
ONLINE_WINDOW = 90.0 # 心跳每 30s 一次(后台标签被节流为 60s),超 90s 无心跳判离线
_ONLINE: dict = {} # machine_id -> 最近心跳时间戳(进程内存)
_ONLINE_LOCK = threading.Lock()
def online_beat(payload: dict) -> tuple:
"""POST /online:访客在线心跳。
- guest=true(未登录)→ 记为在线;guest=false(已登录)→ 移出统计。
- 「停留超过 1 分钟才算在线」由前端控制:打开满 60s 才发首次心跳。
"""
machine = str(payload.get("machine_id") or "").strip()
if not machine or not MACHINE_RE.match(machine):
return 400, {"code": 400, "message": "无效 machine_id"}
guest = bool(payload.get("guest"))
now = time.time()
with _ONLINE_LOCK:
if guest:
_ONLINE[machine] = now
else:
_ONLINE.pop(machine, None) # 登录用户不统计
if len(_ONLINE) > 5000: # 防内存膨胀:修剪过期
for k in [k for k, t in _ONLINE.items() if now - t > ONLINE_WINDOW]:
_ONLINE.pop(k, None)
count = sum(1 for t in _ONLINE.values() if now - t <= ONLINE_WINDOW)
return 200, {"code": 200, "message": "ok", "data": {"online": count}}
def online_count() -> int:
now = time.time()
with _ONLINE_LOCK:
return sum(1 for t in _ONLINE.values() if now - t <= ONLINE_WINDOW)
def _dir_size(path: str) -> int:
total = 0
for root, _dirs, files in os.walk(path):
@@ -1196,6 +1272,28 @@ def admin_api(method: str, sub: str, payload: dict, handler):
_save_reco(clean)
return 200, {"code": 200, "message": "ok"}
# ---------- 站内留言反馈(管理端查看/改状态/删除) ----------
if method == "GET" and sub == "/feedback":
items = sorted(_load_feedback(), key=lambda x: float(x.get("ts") or 0), reverse=True)
return 200, {"code": 200, "message": "ok", "data": items}
if method == "POST" and sub == "/feedback":
fid = str(payload.get("id") or "")
if not fid:
return 400, {"code": 400, "message": "缺少留言 id"}
with FEEDBACK_LOCK:
items = _load_feedback()
hit = next((it for it in items if it.get("id") == fid), None)
if not hit:
return 404, {"code": 404, "message": "留言不存在"}
if str(payload.get("action") or "") == "delete":
items = [it for it in items if it.get("id") != fid]
else:
status = str(payload.get("status") or "new")
hit["status"] = status if status in ("new", "replied", "done") else "new"
_save_feedback(items)
return 200, {"code": 200, "message": "ok"}
if method == "GET" and sub == "/storage":
total = _dir_size(USERS_ROOT) if os.path.isdir(USERS_ROOT) else 0
for extra in ("users.db", "usage.db", "trials.json"):
@@ -1279,14 +1377,23 @@ def admin_api(method: str, sub: str, payload: dict, handler):
by_tool = conn.execute("SELECT tool, COUNT(*) c FROM usage WHERE at>? GROUP BY tool ORDER BY c DESC LIMIT 30", (since,)).fetchall()
by_user = conn.execute("SELECT username, COUNT(*) c, MAX(at) last FROM usage WHERE at>? AND username!='' GROUP BY username ORDER BY c DESC LIMIT 50", (since,)).fetchall()
total = conn.execute("SELECT COUNT(*) FROM usage WHERE at>?", (since,)).fetchone()[0]
# 未登录访客(username 为空)聚合:访客的功能使用也统计并展示
g = conn.execute("SELECT COUNT(*) c, MAX(at) last FROM usage WHERE at>? AND username=''", (since,)).fetchone()
conn.close()
return 200, {"code": 200, "message": "ok", "data": {
"days": days,
"total": total,
"by_tool": [{"tool": t, "count": c} for t, c in by_tool],
"by_user": [{"username": u, "count": c, "last": int(l or 0)} for u, c, l in by_user],
"guest": {"count": int(g[0] or 0), "last": int(g[1] or 0)},
"online": online_count(),
}}
if method == "GET" and sub == "/mcp-usage":
qs = parse.parse_qs(parse.urlparse(handler.path).query)
days = _int_str((qs.get("days") or ["7"])[0], 1, 365, 7)
return 200, {"code": 200, "message": "ok", "data": mcp_ops.mcp_usage_query(days)}
return 404, {"code": 404, "message": "unknown admin api"}
@@ -1367,6 +1474,198 @@ def verify_captcha(payload) -> bool:
return _secrets.compare_digest(stored, got)
# ============ 站内留言反馈(独立于卡密/授权系统,任何人可用) ============
# ---- CardAuth hub 接入(项目 6):在线统计上报 + 公告推送,失败开放(不可达不影响站点) ----
HUB_TIMEOUT = 8
def hub_announcements(limit: int = 20) -> tuple[int, dict]:
"""GET /hub/announcements — 服务端拉本项目公告,双保险过滤 project_id。"""
try:
res = _get_json(
f"/public/announcements?target=client&project_id={PROJECT_ID}&limit={max(1, min(int(limit), 50))}",
{}, timeout=HUB_TIMEOUT)
except Exception as exc: # noqa: BLE001
print(f"[hub] announcements failed: {exc}", flush=True)
return 503, {"code": 503, "message": "公告服务暂不可用",
"data": {"list": [], "popup": []}}
data = (res or {}).get("data") or {}
def mine(arr) -> list:
out = []
for a in arr or []:
if not isinstance(a, dict):
continue
pid = a.get("project_id")
if pid in (None, "", 0) or str(pid) == str(PROJECT_ID):
out.append(a)
return out
return 200, {"code": 200, "message": "ok",
"data": {"list": mine(data.get("list")), "popup": mine(data.get("popup"))}}
def hub_report(payload: dict) -> tuple[int, dict]:
"""POST /hub/report {machine_id, client_version, device_info}
— 安装登记(安装统计)+ 心跳(在线统计),顺带返回版本推送信息。"""
machine = str(payload.get("machine_id") or "")
version = str(payload.get("client_version") or "0")[:40]
device = str(payload.get("device_info") or "")[:200] or "web"
if not MACHINE_RE.match(machine):
return 400, {"code": 400, "message": "机器码格式错误"}
if not (CARD_AUTH_KEY and PROJECT_ID):
return 503, {"code": 503, "message": "授权中心未配置"}
hdr = {"X-Api-Key": CARD_AUTH_KEY, "X-Project-Id": str(PROJECT_ID)}
out: dict = {"install_id": None, "latest_version": "",
"update_available": False, "update_required": False,
"download_url": None, "changelog": None, "online": False}
# 心跳必须在 check-update 之前:实测 CardAuth heartbeat 会把
# client_version/device_info 清空,check-update 放最后确保版本号落库
try:
hb = _post_json("/public/installations/heartbeat", {"machine_id": machine},
hdr, timeout=HUB_TIMEOUT)
out["online"] = (hb or {}).get("code") == 200
except Exception as exc: # noqa: BLE001
print(f"[hub] heartbeat failed: {exc}", flush=True)
try:
res = _post_json("/public/installations/check-update",
{"machine_id": machine, "client_version": version,
"device_info": device}, hdr, timeout=HUB_TIMEOUT)
d = (res or {}).get("data") or {}
out.update({
"install_id": d.get("install_id"),
"latest_version": d.get("latest_version") or "",
"update_available": bool(d.get("update_available")),
"update_required": bool(d.get("update_required")),
"download_url": d.get("download_url"),
"changelog": d.get("changelog"),
})
except Exception as exc: # noqa: BLE001
print(f"[hub] check-update failed: {exc}", flush=True)
return 503, {"code": 503, "message": "授权中心暂不可用", "data": out}
return 200, {"code": 200, "message": "ok", "data": out}
# GET /feedback/captcha 图形验证码
# POST /feedback {type,content,contact,captcha_id,captcha_code}
FEEDBACK_FILE = os.path.join(DATA_DIR, "feedback.json")
FEEDBACK_TYPES = ("功能建议", "意见反馈")
FEEDBACK_WINDOW = 3600 # 同一 IP 两次提交的最小间隔(秒,1 小时)
FEEDBACK_MAX = 2000 # 存档上限,超出丢弃最旧
FEEDBACK_LOCK = threading.Lock()
def _load_feedback() -> list:
try:
with open(FEEDBACK_FILE, "r", encoding="utf-8") as fh:
data = json.load(fh)
return data if isinstance(data, list) else []
except Exception: # noqa: BLE001
return []
def _save_feedback(items: list) -> None:
tmp = FEEDBACK_FILE + ".tmp"
with open(tmp, "w", encoding="utf-8") as fh:
json.dump(items, fh, ensure_ascii=False, indent=1)
os.replace(tmp, FEEDBACK_FILE)
def _ip_is_public(value: str) -> bool:
try:
import ipaddress
ip = ipaddress.ip_address(value)
except Exception: # noqa: BLE001
return False
return not (
ip.is_private or ip.is_loopback or ip.is_link_local
or ip.is_reserved or ip.is_multicast
)
def _real_client_ip(handler) -> str:
"""取真实客户端 IP(限频用)。
链路:浏览器 → nps/frp 隧道(注入真实 IP 的 X-Forwarded-For)
→ nginx(再追加 $remote_addr = 隧道/内网地址)→ relay。
因此 XFF 从右往左取第一个公网地址:先跳过隧道与内网地址,
客户端在链路最左侧伪造的头也不会被采信。
"""
raw = handler.headers.get("X-Forwarded-For") or handler.headers.get("X-Real-IP") or ""
parts = [p.strip() for p in raw.split(",") if p.strip()]
for part in reversed(parts):
if _ip_is_public(part):
return part
if parts:
return parts[0]
try:
return handler.client_address[0] or "unknown"
except Exception: # noqa: BLE001
return "unknown"
def feedback_api(method: str, payload: dict, handler) -> tuple:
"""公开留言接口:GET 出图形验证码,POST 提交留言。"""
if method == "GET":
if not _HAS_PIL:
return 503, {"code": 503, "message": "验证码组件未就绪,请稍后再试"}
cid, img_b64 = _gen_captcha()
return 200, {"code": 200, "message": "ok", "data": {"id": cid, "img": img_b64}}
# POST:先人机验证,再业务校验,最后同 IP 1 小时限频
if not verify_captcha(payload):
return 403, {"code": 403, "message": "人机验证失败,请刷新验证码后重试"}
ftype = str(payload.get("type") or "").strip()
if ftype not in FEEDBACK_TYPES:
return 400, {"code": 400, "message": "请选择留言类型:功能建议 / 意见反馈"}
content = str(payload.get("content") or "").replace("\r\n", "\n").strip()
if not content:
return 400, {"code": 400, "message": "请填写留言内容"}
if len(content) > 1000:
return 400, {"code": 400, "message": "留言内容最多 1000 字"}
contact = str(payload.get("contact") or "").strip()
if len(contact) > 64:
return 400, {"code": 400, "message": "联系方式最多 64 字"}
if any(ord(c) < 32 for c in contact):
return 400, {"code": 400, "message": "联系方式含非法字符"}
ip = _real_client_ip(handler)
now = time.time()
with FEEDBACK_LOCK:
items = _load_feedback()
last_ts = 0.0
for it in reversed(items):
if it.get("ip") == ip:
try:
last_ts = float(it.get("ts") or 0)
except Exception: # noqa: BLE001
last_ts = 0.0
break
if now - last_ts < FEEDBACK_WINDOW:
wait_min = max(int((FEEDBACK_WINDOW - (now - last_ts)) / 60), 1)
return 429, {"code": 429, "message": f"同一 IP 一小时内只能提交一次,请 {wait_min} 分钟后再试"}
items.append({
"id": f"{int(now)}-{secrets.token_hex(4)}",
"ts": int(now),
"ip": ip,
"type": ftype,
"content": content,
"contact": contact,
"status": "new",
})
if len(items) > FEEDBACK_MAX:
items = items[-FEEDBACK_MAX:]
_save_feedback(items)
print(f"[feedback] new from {ip} [{ftype}] {len(content)} chars", flush=True)
return 200, {"code": 200, "message": "ok"}
def user_api(method, sub, payload, handler):
"""returns (status, body_dict)"""
if method == "GET" and sub == "/captcha":
@@ -1651,6 +1950,23 @@ class Handler(BaseHTTPRequestHandler):
if parsed.path == "/ai/models":
self._handle_ai_models()
return
if parsed.path == "/mcp":
info = {"code": 200,
"message": "IT-TOOLS-PRO MCP endpoint (Streamable HTTP / JSON-RPC 2.0)",
"protocol": "mcp",
"endpoint": "/mcp",
"auth": "Authorization: Bearer <MCP令牌>(站内「MCP 接入」页购买卡密后生成)",
"tools": [t["name"] for t in mcp_ops.TOOLS]}
self._reply(200, json.dumps(info, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/mcp/tokens":
qs = parse.parse_qs(parsed.query)
status, body = mcp_ops.tokens_api("GET", {}, qs)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path.startswith("/mcp/file/"):
mcp_ops.handle_get_file(self, parsed.path[len("/mcp/file/"):])
return
if parsed.path.startswith("/admin"):
self._handle_admin("GET")
return
@@ -1670,6 +1986,21 @@ class Handler(BaseHTTPRequestHandler):
self._reply(200, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/feedback/captcha":
status, body = feedback_api("GET", {}, self)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/hub/announcements":
qs = parse.parse_qs(parsed.query or "")
try:
limit = int((qs.get("limit") or ["20"])[0] or 20)
except ValueError:
limit = 20
status, body = hub_announcements(limit)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/reco":
items = [x for x in _load_reco() if x.get("enabled")][:24]
body = json.dumps({"code": 200, "message": "ok", "data": items}, ensure_ascii=False).encode("utf-8")
@@ -2554,6 +2885,35 @@ class Handler(BaseHTTPRequestHandler):
if parsed.path == "/speed":
self._handle_speed_post()
return
if parsed.path == "/feedback":
payload = self._read_payload()
status, body = feedback_api("POST", payload, self)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/hub/report":
payload = self._read_payload() or {}
status, body = hub_report(payload)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/usage":
payload = self._read_payload() or {}
status, body = usage_track(payload, self)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/online":
payload = self._read_payload() or {}
status, body = online_beat(payload)
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path == "/mcp":
status, body, ctype = mcp_ops.handle_post(self)
self._reply(status, body, ctype)
return
if parsed.path == "/mcp/tokens":
payload = self._read_payload() or {}
status, body = mcp_ops.tokens_api("POST", payload, {})
self._reply(status, json.dumps(body, ensure_ascii=False).encode("utf-8"), "application/json")
return
if parsed.path.startswith("/admin"):
self._handle_admin("POST")
return
@@ -3896,5 +4256,13 @@ def _news_loop():
if __name__ == "__main__":
_ensure_admin()
mcp_ops.setup(
data_dir=DATA_DIR,
usage_db=USAGE_DB,
query_authorized=query_authorized,
account_ok=_account_license_ok,
machine_ok=lambda m: bool(MACHINE_RE.match(m)),
public_base=os.environ.get("MCP_PUBLIC_BASE", ""),
)
threading.Thread(target=_news_loop, daemon=True).start()
ThreadingHTTPServer(("0.0.0.0", 8091), Handler).serve_forever()
+4
View File
@@ -274,6 +274,10 @@ tools:
title: Translator
description: Text translation in 16 languages with automatic detection - Chinese/English runs on a local open-source engine (no rate limits), other languages automatically fall back to MyMemory. Full-document translation (Chinese/English); scanned PDFs and images are OCR-recognized before translation.
mcp-connect:
title: 'MCP Connect (let AI call site tools)'
description: 'Let Claude, Hermes and other MCP clients call the 13 licensed tools directly (translate, OCR, image gen, video processing and more). See the setup guide, create and manage access tokens; a purchase link is shown until a card is activated.'
image-ocr:
title: Image OCR
description: Extract text from images with OCR - click, drag & drop or paste a screenshot, get recognized lines with confidence scores, copy or download as TXT.
+4
View File
@@ -271,6 +271,10 @@ tools:
title: 在线翻译
description: 文本翻译支持中英日韩法德等 16 种语言,自动识别源语言:中英互译走本地开源引擎不限流,其他语种自动切 MyMemory 备用线路;文档整篇翻译(中英),扫描件/图片自动 OCR 识别后翻译,修改文本自动翻译。
mcp-connect:
title: MCP 接入(AI 调用本站工具)
description: 让 Claude、Hermes 等 AI 客户端通过 MCP 协议直接调用本站 13 个授权工具(翻译、OCR、生图、视频处理等);查看接入教程、生成与管理调用令牌,未购买卡密时提供购买入口。
image-ocr:
title: 图片OCR文字识别
description: 上传、拖拽或粘贴截图识别图片中的文字,逐行输出识别结果和置信度,支持复制全部和下载TXT。
+14
View File
@@ -32,6 +32,20 @@ server {
proxy_read_timeout 30s;
}
# MCP endpoint (JSON-RPC streamable HTTP + result file download).
# Relay does its own Bearer-token auth here — no auth_request subrequest.
# Boundary regex: must NOT swallow the /mcp-connect SPA page (prefix /mcp would).
location ~ ^/mcp(/|$) {
client_max_body_size 60m;
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_pass http://it-tools-relay:8091;
proxy_connect_timeout 5s;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
}
# license relay (card activation etc; auth gate itself must stay open)
location /relay/ {
client_max_body_size 2g;
+15 -1
View File
@@ -2,7 +2,7 @@
import { NIcon, useThemeVars } from 'naive-ui';
import { RouterLink } from 'vue-router';
import { Heart, Home2, Key, Menu2 } from '@vicons/tabler';
import { Heart, Home2, Key, Menu2, Plug } from '@vicons/tabler';
import { storeToRefs } from 'pinia';
import HeroGradient from '../assets/hero-gradient.svg?component';
@@ -358,6 +358,20 @@ onBeforeUnmount(() => {
</RouterLink>
</c-tooltip>
<!-- 全站右上角:MCP 接入(教程/令牌管理入口,未购卡密显示购买链接) -->
<c-tooltip position="bottom" :tooltip="'MCP 接入:让 AI 助手直接调用本站工具'">
<RouterLink to="/mcp-connect" class="pricing-link">
<c-button
round
class="support-button"
:bordered="false"
>
MCP
<NIcon v-if="!styleStore.isSmallScreen" :component="Plug" ml-2 />
</c-button>
</RouterLink>
</c-tooltip>
<!-- 全站右上角:IPv6 直连切换(仅公网域名且探测到本机有 IPv6 时显示) -->
<c-tooltip
v-if="onV6Host || v6ok"
+1 -1
View File
@@ -40,7 +40,7 @@ useHead(head);
const { t } = useI18n();
// 宽屏工具:不受 600px 限宽,占满可用宽度(画布/多栏类工具)
const WIDE_TOOLS = new Set(['/label-designer', '/json-prettify', '/pdf-tools', '/image-tools', '/doc-convert', '/video-tools', '/seal-maker', '/signature-pad', '/ai-image-lab', '/ai-chat', '/copywriting', '/ai-gen', '/code-reader', '/my-ip']);
const WIDE_TOOLS = new Set(['/label-designer', '/json-prettify', '/pdf-tools', '/image-tools', '/doc-convert', '/video-tools', '/seal-maker', '/signature-pad', '/ai-image-lab', '/ai-chat', '/copywriting', '/ai-gen', '/code-reader', '/my-ip', '/mcp-connect']);
const isWide = computed(() => WIDE_TOOLS.has(route.path));
const i18nKey = computed<string>(() => route.path.trim().replace('/', ''));
+71 -2
View File
@@ -291,6 +291,15 @@ async function loadUsage() {
usage.value = b.data;
}
// ============ MCP 调用记录 ============
const mcpDays = ref(7);
const mcpData = ref<any>(null);
async function loadMcpUsage() {
const b = await api(`/admin/mcp-usage?days=${mcpDays.value}`);
mcpData.value = b.data;
}
const TOOL_LABELS: Record<string, string> = {
'translator': '在线翻译',
'image-ocr': '图片OCR',
@@ -456,12 +465,12 @@ function recoMove(i: number, d: -1 | 1) {
reco.value.splice(j, 0, it);
}
const tab = ref<'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'feedback'>('overview');
const tab = ref<'overview' | 'files' | 'usage' | 'mcp' | 'storage' | 'reco' | 'feedback'>('overview');
// 在线人数 30s 自动刷新(切走用量页签即停)
let usageTimer: ReturnType<typeof setInterval> | null = null;
function switchTab(id: 'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'feedback') {
function switchTab(id: 'overview' | 'files' | 'usage' | 'mcp' | 'storage' | 'reco' | 'feedback') {
if (usageTimer) {
clearInterval(usageTimer);
usageTimer = null;
@@ -477,6 +486,9 @@ function switchTab(id: 'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'fe
loadUsage();
usageTimer = setInterval(loadUsage, 30000);
}
if (id === 'mcp') {
loadMcpUsage();
}
if (id === 'storage') {
loadStorage();
}
@@ -512,6 +524,7 @@ function switchTab(id: 'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'fe
<div class="adm-nav-item" :class="{ active: tab === 'overview' }" @click="switchTab('overview')">📊 总览与用户</div>
<div class="adm-nav-item" :class="{ active: tab === 'files' }" @click="switchTab('files')">📁 文件管理</div>
<div class="adm-nav-item" :class="{ active: tab === 'usage' }" @click="switchTab('usage')">📈 使用统计</div>
<div class="adm-nav-item" :class="{ active: tab === 'mcp' }" @click="switchTab('mcp')">🤖 MCP 调用</div>
<div class="adm-nav-item" :class="{ active: tab === 'storage' }" @click="switchTab('storage')">💾 存储设置</div>
<div class="adm-nav-item" :class="{ active: tab === 'reco' }" @click="switchTab('reco')">🏠 首页推荐</div>
<div class="adm-nav-item" :class="{ active: tab === 'feedback' }" @click="switchTab('feedback')">
@@ -726,6 +739,50 @@ function switchTab(id: 'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'fe
</div>
</template>
<!-- MCP 调用记录:AI 客户端经 /mcp 调用本站工具的流水 -->
<template v-if="tab === 'mcp'">
<div class="adm-toolbar">
<select v-model.number="mcpDays" class="adm-select" @change="loadMcpUsage">
<option :value="7">近 7 天</option>
<option :value="30">近 30 天</option>
<option :value="90">近 90 天</option>
</select>
<span v-if="mcpData" class="adm-sub">总调用:{{ mcpData.total }}(成功 {{ mcpData.ok_total }})</span>
<span v-else class="adm-sub">加载中…</span>
</div>
<div class="adm-usage-grid">
<div>
<h3 class="adm-h3">工具调用排行</h3>
<div v-for="t in mcpData?.by_tool ?? []" :key="t.tool" class="adm-bar-row">
<span class="adm-bar-label">{{ t.tool }}</span>
<div class="adm-bar-track"><div class="adm-bar" :style="{ width: Math.min(100, t.count * 100 / Math.max(1, mcpData.by_tool[0].count)) + '%' }" /></div>
<span class="adm-bar-count">{{ t.count }}</span>
</div>
<div v-if="!mcpData?.by_tool?.length" class="adm-none">暂无 MCP 调用记录</div>
</div>
<div>
<h3 class="adm-h3">调用流水(最近 {{ mcpData?.rows?.length ?? 0 }} 条)</h3>
<div class="adm-mcp-scroll">
<table class="adm-table">
<thead><tr><th>时间</th><th>令牌</th><th>机器码</th><th>工具</th><th>结果</th><th>耗时</th><th>错误</th></tr></thead>
<tbody>
<tr v-for="(r, i) in mcpData?.rows ?? []" :key="i">
<td>{{ fmtTime(r.at) }}</td>
<td>…{{ r.token_tail }}</td>
<td>{{ r.machine }}</td>
<td>{{ r.tool }}</td>
<td :style="{ color: r.ok ? '#16a34a' : '#dc2626', fontWeight: 600 }">{{ r.ok ? '✓ 成功' : '✗ 失败' }}</td>
<td>{{ r.dur_ms }} ms</td>
<td class="adm-mcp-err">{{ r.err || '—' }}</td>
</tr>
<tr v-if="!mcpData?.rows?.length"><td colspan="7" class="adm-none">暂无 MCP 调用记录</td></tr>
</tbody>
</table>
</div>
</div>
</div>
</template>
<!-- 留言反馈:网站访客提交的留言,按时间倒序 -->
<template v-if="tab === 'feedback'">
<div class="adm-toolbar">
@@ -1372,6 +1429,18 @@ function switchTab(id: 'overview' | 'files' | 'usage' | 'storage' | 'reco' | 'fe
line-height: 1.7;
}
.adm-mcp-scroll {
max-height: 420px;
overflow: auto;
}
.adm-mcp-err {
max-width: 260px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: #dc2626;
font-size: 12px;
}
.adm-usage-grid {
display: grid;
grid-template-columns: 1fr 1fr;
+2
View File
@@ -93,6 +93,7 @@ import { tool as pinyinConverter } from './pinyin-converter';
import { tool as aiImageLab } from './ai-image-lab';
import { tool as aiChat } from './ai-chat';
import { tool as copywriting } from './copywriting';
import { tool as mcpConnect } from './mcp-connect';
import { tool as docConvert } from './doc-convert';
import { tool as aiRetouch } from './ai-retouch';
import { tool as wifiQrCodeGenerator } from './wifi-qr-code-generator';
@@ -170,6 +171,7 @@ export const toolsByCategory: ToolCategory[] = [
{
name: 'Development',
components: [
mcpConnect,
gitMemo,
randomPortGenerator,
crontabGenerator,
+641
View File
@@ -0,0 +1,641 @@
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue';
import { Plug, Plus, Trash } from '@vicons/tabler';
import { checkAuth, getMachineId } from '../license/license';
// ===== 连接信息 =====
const endpoint = `${window.location.origin}/mcp`;
const loading = ref(true);
const authorized = ref(false);
const machine = getMachineId();
// ===== 令牌管理 =====
interface McpToken {
token: string;
machine: string;
note: string;
created: number;
last_used: number;
calls: number;
}
const tokens = ref<McpToken[]>([]);
const genNote = ref('');
const busy = ref(false);
const copiedKey = ref('');
onMounted(async () => {
authorized.value = await checkAuth();
if (authorized.value) {
await loadTokens();
// 已购本站授权的设备:没有令牌就自动建一个默认的,打开页面即可复制即用
if (!tokens.value.length) {
genNote.value = '默认';
await genToken();
}
}
loading.value = false;
});
// ===== 主令牌(列表第一条,配置示例与大展示块都用它) =====
const primaryToken = computed(() => tokens.value[0]?.token ?? '');
async function loadTokens() {
try {
const res = await fetch(`/relay/mcp/tokens?machine_id=${encodeURIComponent(machine)}`);
const j = await res.json();
if (j?.code === 200) tokens.value = j.data?.tokens ?? [];
} catch { /* 网络错误静默,页面仍可展示端点信息 */ }
}
async function genToken() {
if (busy.value) return;
busy.value = true;
try {
const res = await fetch('/relay/mcp/tokens', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ machine_id: machine, note: genNote.value }),
});
const j = await res.json();
if (j?.code === 200) {
genNote.value = '';
await loadTokens();
} else {
window.alert(j?.message || '生成失败');
}
} catch {
window.alert('网络错误,请稍后重试');
} finally {
busy.value = false;
}
}
async function delToken(tok: McpToken) {
if (!window.confirm(`确定删除令牌「${tok.note || 'MCP 客户端'}」?删除后使用该令牌的 AI 客户端将立即失效。`)) return;
try {
const res = await fetch('/relay/mcp/tokens', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ machine_id: machine, action: 'delete', token: tok.token }),
});
const j = await res.json();
if (j?.code === 200) await loadTokens();
else window.alert(j?.message || '删除失败');
} catch {
window.alert('网络错误,请稍后重试');
}
}
async function copyText(text: string, key: string) {
try {
await navigator.clipboard.writeText(text);
copiedKey.value = key;
setTimeout(() => (copiedKey.value = ''), 1600);
} catch {
window.alert('复制失败,请手动选择复制');
}
}
function fmtTime(ts: number) {
if (!ts) return '—';
const d = new Date(ts * 1000);
const p = (n: number) => String(n).padStart(2, '0');
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
}
// ===== 客户端配置示例(授权机自动带真实主令牌,复制即用;未授权显示占位) =====
const tokPlaceholder = 'mcpt_你的令牌';
const tokForCfg = () => primaryToken.value || tokPlaceholder;
const hermesCfg = computed(
() => `mcp_servers:
ittools-pro:
url: "${endpoint}"
headers:
Authorization: "Bearer ${tokForCfg()}"
timeout: 600`,
);
const jsonCfg = computed(
() => JSON.stringify(
{
mcpServers: {
'it-tools-pro': {
type: 'http',
url: endpoint,
headers: { Authorization: `Bearer ${tokForCfg()}` },
},
},
},
null,
2,
),
);
const curlCfg = computed(
() => `curl -sS ${endpoint} \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer ${tokForCfg()}' \\
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'`,
);
// ===== 接入后怎么使用:场景话术示例 =====
const usageExamples = [
{ scene: '文本翻译', say: '把这段话翻译成英文:公司的季度报告明天提交', tool: 'translate_text', got: '直接返回译文' },
{ scene: '图片文字识别', say: '识别这张截图里的文字 /home/pics/发票.png', tool: 'ocr', got: '逐行文字 + 置信度' },
{ scene: '整篇文档翻译', say: '把这份合同翻译成英文 /home/docs/合同.docx', tool: 'translate_doc', got: '译文全文(约 1-2 分钟)' },
{ scene: '文字转语音', say: '把这段开场白合成一段普通话音频:大家好…', tool: 'tts', got: 'mp3 下载链接' },
{ scene: '音频转文字', say: '把这段录音转成文字 /home/voice/meeting.mp3', tool: 'speech_to_text', got: '带时间轴的识别文本' },
{ scene: '视频生成字幕', say: '给这个视频生成中文字幕 /home/video/demo.mp4', tool: 'extract_subtitle', got: '带时间轴的字幕分段' },
{ scene: '视频批处理', say: '把这个视频压缩小一点 /home/video/big.mp4', tool: 'video_process', got: '处理后的视频下载链接' },
{ scene: 'AI 生图', say: '画一张赛博朋克风格的雨夜城市插画', tool: 'gen_image', got: '图片下载链接' },
{ scene: '文档格式转换', say: '把这份 PDF 转成可编辑的 Word /home/docs/资料.pdf', tool: 'convert_doc', got: '转换后文件下载链接' },
{ scene: '图片抠图', say: '把这张商品图的背景去掉 /home/pics/shirt.jpg', tool: 'remove_bg', got: '透明底 PNG 链接' },
{ scene: '图片放大', say: '把这张老照片放大两倍变清晰 /home/pics/old.jpg', tool: 'upscale_image', got: '高清大图链接' },
{ scene: '文案改写', say: '把这段文案改写得更口语化发朋友圈:…', tool: 'copywriting', got: '改写后的文案' },
{ scene: '看图问答', say: '这张图里写了什么?/home/pics/chart.png', tool: 'vision_qa', got: '对图片内容的解答' },
];
// ===== 接入后排错速查 =====
const mcpTroubles = [
{ code: '连接成功但 AI 说没有相关工具', fix: '检查客户端配置是否已保存并重启/重连;工具列表里应出现 13 个本站工具(或让 AI「列出你能调用的工具」自检)' },
{ code: '401 unauthorized', fix: '令牌没带上、拼错、或已被删除——复制页内最新令牌替换配置里的 Bearer 值' },
{ code: '授权已失效 / 403', fix: '卡密过期或授权被撤销——续费购买新卡并重新激活后,原令牌自动恢复可用' },
{ code: '连接超时', fix: '生图、文档翻译、视频处理是慢操作——把客户端 timeout 调到 ≥ 600 秒再试' },
{ code: '文件不存在', fix: '文件类工具传服务器可读的绝对路径;与站点同机直接传本机路径即可' },
];
// ===== 可调用的 13 个工具 =====
const mcpTools = [
{ name: 'translate_text', desc: '文本翻译(谷歌引擎,多语言互译)' },
{ name: 'ocr', desc: '图片/PDF 文字识别,逐行文本+置信度(PDF 自动逐页)' },
{ name: 'translate_doc', desc: '整篇文档翻译(docx/pdf → 译文全文)' },
{ name: 'tts', desc: '文字合成语音(mp3 下载链接)' },
{ name: 'speech_to_text', desc: '音频/语音转文字(ASR)' },
{ name: 'extract_subtitle', desc: '视频字幕 AI 识别(带时间轴)' },
{ name: 'video_process', desc: '视频批处理:转码/压缩/裁剪/去水印/截图/GIF 等 14 种' },
{ name: 'gen_image', desc: 'AI 文生图(图片下载链接)' },
{ name: 'convert_doc', desc: '文档格式转换(pdf/docx/xlsx/pptx 互转)' },
{ name: 'remove_bg', desc: '图片抠图去背景(透明底 PNG)' },
{ name: 'upscale_image', desc: '图片超分放大(2x/4x)并降噪' },
{ name: 'copywriting', desc: '文案工具:改写/降AIGC/爆款标题/小红书/朋友圈' },
{ name: 'vision_qa', desc: '看图问答:描述/提取/判断图片内容' },
];
</script>
<template>
<div class="mcp-page">
<n-spin :show="loading">
<!-- ===== 状态横幅 ===== -->
<n-card class="mcp-card" :bordered="true">
<template #header>
<div class="mcp-h">
<Plug :size="20" />
<span>MCP 接入:让 AI 助手直接调用本站 13 个工具</span>
</div>
</template>
<n-alert v-if="authorized" type="success" :show-icon="true">
本设备已授权 ✓ — 可生成 MCP 令牌,接入任意支持 MCP 的 AI 客户端(Hermes / Claude / Cherry Studio 等)。
</n-alert>
<div v-else class="mcp-buy">
<n-alert type="warning" :show-icon="true">
本设备尚未授权:<b>购买卡密并激活</b>后才能生成 MCP 令牌、调用本站 MCP。
</n-alert>
<div class="mcp-buy-row">
<c-button type="primary" to="/buy">
💳 前往购买卡密
</c-button>
<c-button @click="copyText(machine, 'machine')">
{{ copiedKey === 'machine' ? '✓ 已复制机器码' : `复制机器码 ${machine}` }}
</c-button>
<span class="mcp-hint">激活时在卡密页粘贴上方机器码</span>
</div>
</div>
</n-card>
<!-- ===== 连接信息 ===== -->
<n-card class="mcp-card" title="① 连接信息" :bordered="true">
<div class="mcp-row">
<span class="mcp-label">端点地址</span>
<code class="mcp-code">{{ endpoint }}</code>
<c-button size="small" @click="copyText(endpoint, 'ep')">
{{ copiedKey === 'ep' ? '✓ 已复制' : '复制' }}
</c-button>
</div>
<div class="mcp-row">
<span class="mcp-label">协议</span>
<span>MCP Streamable HTTP(JSON-RPC 2.0),所有支持 HTTP 传输的 MCP 客户端均可接入</span>
</div>
<div class="mcp-row">
<span class="mcp-label">鉴权</span>
<span>请求头 <code class="mcp-code">Authorization: Bearer &lt;你的MCP令牌&gt;</code>(下方生成)</span>
</div>
<div class="mcp-row">
<span class="mcp-label">机器码</span>
<code class="mcp-code">{{ machine }}</code>
<c-button size="small" @click="copyText(machine, 'machine2')">
{{ copiedKey === 'machine2' ? '✓ 已复制' : '复制' }}
</c-button>
</div>
</n-card>
<!-- ===== 令牌管理 ===== -->
<n-card class="mcp-card" :bordered="true">
<template #header>
<div class="mcp-h">
<span>② MCP 令牌(调用凭证)</span>
</div>
</template>
<template v-if="authorized">
<div class="mcp-auth-ok">
✓ 本设备已获授权(与站内卡密为同一套,购买并激活后即可直接调用,无需单独开通 MCP)
</div>
<div v-if="primaryToken" class="mcp-primary">
<div class="mcp-primary-label">本设备可用令牌 — 复制即用,③ 的配置已自动带好:</div>
<div class="mcp-primary-body">
<code class="mcp-primary-token">{{ primaryToken }}</code>
<c-button size="small" type="primary" @click="copyText(primaryToken, 'ptok')">
{{ copiedKey === 'ptok' ? '✓ 已复制' : '复制令牌' }}
</c-button>
</div>
</div>
<div class="mcp-gen-row">
<n-input
v-model:value="genNote"
placeholder="备注,如:Hermes / Claude(可空)"
:maxlength="40"
style="max-width: 320px"
@keydown.enter="genToken"
/>
<c-button type="primary" :loading="busy" @click="genToken">
<Plus :size="14" />&nbsp;生成令牌
</c-button>
<span class="mcp-hint">每台设备最多 10 个;令牌等同授权凭证,泄露请立即删除重建</span>
</div>
<div v-if="tokens.length" class="mcp-tokens-scroll">
<table class="mcp-table">
<thead>
<tr>
<th>备注</th>
<th>令牌</th>
<th>创建时间</th>
<th>调用次数</th>
<th>最后使用</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr v-for="t in tokens" :key="t.token">
<td>{{ t.note || '—' }}</td>
<td class="mcp-tok-cell">
<code class="mcp-code">{{ t.token }}</code>
<c-button size="small" @click="copyText(t.token, t.token)">
{{ copiedKey === t.token ? '✓' : '复制' }}
</c-button>
</td>
<td>{{ fmtTime(t.created) }}</td>
<td>{{ t.calls ?? 0 }}</td>
<td>{{ fmtTime(t.last_used) }}</td>
<td>
<c-button size="small" @click="delToken(t)">
<Trash :size="13" />&nbsp;删除
</c-button>
</td>
</tr>
</tbody>
</table>
</div>
<n-empty v-else description="还没有令牌,点击上方「生成令牌」创建" class="mcp-empty" />
</template>
<n-alert v-else type="info" :show-icon="true">
未授权:购买卡密并激活后可在此生成令牌。
<c-button size="small" type="primary" to="/buy" style="margin-left: 8px">
💳 前往购买卡密
</c-button>
</n-alert>
</n-card>
<!-- ===== 客户端配置 ===== -->
<n-card class="mcp-card" title="③ AI 客户端配置(令牌已自动带好,直接复制保存)" :bordered="true">
<n-tabs type="line" animated>
<n-tab-pane name="hermes" tab="Hermes(config.yaml)">
<div class="mcp-codeblock">
<pre>{{ hermesCfg }}</pre>
<c-button size="small" class="mcp-copy-btn" @click="copyText(hermesCfg, 'hermes')">
{{ copiedKey === 'hermes' ? '✓ 已复制' : '复制' }}
</c-button>
</div>
<p class="mcp-note">
保存后重启 Hermes 网关(<code>hermes gateway restart</code>),即可对 AI 说
“把这张图识别出文字 / 翻译这段话 / 生成一张图” 等,AI 会自动调用。
</p>
</n-tab-pane>
<n-tab-pane name="json" tab="通用(Claude / Cherry Studio 等)">
<div class="mcp-codeblock">
<pre>{{ jsonCfg }}</pre>
<c-button size="small" class="mcp-copy-btn" @click="copyText(jsonCfg, 'json')">
{{ copiedKey === 'json' ? '✓ 已复制' : '复制' }}
</c-button>
</div>
<p class="mcp-note">
Claude Desktop 若不支持 <code>type: http</code>,可用 mcp-remote 桥接:
<code>npx mcp-remote {{ endpoint }} --header Authorization:"Bearer 你的令牌"</code>
</p>
</n-tab-pane>
<n-tab-pane name="curl" tab="curl 自测">
<div class="mcp-codeblock">
<pre>{{ curlCfg }}</pre>
<c-button size="small" class="mcp-copy-btn" @click="copyText(curlCfg, 'curl')">
{{ copiedKey === 'curl' ? '✓ 已复制' : '复制' }}
</c-button>
</div>
<p class="mcp-note">返回 <code>tools/list</code> 的 13 个工具即接入成功;不带令牌调用 tools/call 会返回 401。</p>
</n-tab-pane>
</n-tabs>
</n-card>
<!-- ===== 接入后怎么使用 ===== -->
<n-card class="mcp-card" title="④ 接入后怎么使用" :bordered="true">
<div class="mcp-steps">
<div class="mcp-step">
<b>第 1 步</b>:把上面的配置复制进 AI 客户端并<b>保存</b>——已授权设备的配置里<b>已自动带上真实令牌</b>,无需手工替换(显示 <code>mcpt_你的令牌</code> 占位说明本机未授权或令牌已删,先看 ②)。
</div>
<div class="mcp-step">
<b>第 2 步</b>:<b>重启 / 重连</b>该客户端(Hermes 执行 <code>hermes gateway restart</code>;聊天类客户端重新打开会话)。
</div>
<div class="mcp-step">
<b>第 3 步</b>:直接用<b>自然语言</b>下达任务,AI 会自己选工具、填参数、把结果带回来——你不需要记任何工具名。
</div>
</div>
<h4 class="mcp-sub">接入成功自检(任选其一)</h4>
<ul class="mcp-notes">
<li>对 AI 说:<b>「列出你能调用的工具」</b>——应看到 13 个本站工具(translate_text、ocr、tts…)。</li>
<li>客户端工具列表 / MCP 面板里应出现本站服务器 <code>it-tools-pro</code> 与 13 个工具。</li>
<li>curl 里执行 ③ 的 <code>tools/list</code> 请求,返回 <code>"tools"</code> 数组含 13 项即链路正常。</li>
</ul>
<h4 class="mcp-sub">典型用法(你只管这样对 AI 说)</h4>
<div class="mcp-tokens-scroll">
<table class="mcp-table">
<thead>
<tr><th>场景</th><th>你对 AI 说</th><th>AI 实际调用</th><th>你得到</th></tr>
</thead>
<tbody>
<tr v-for="u in usageExamples" :key="u.scene">
<td>{{ u.scene }}</td>
<td class="mcp-say">「{{ u.say }}」</td>
<td><code class="mcp-code">{{ u.tool }}</code></td>
<td>{{ u.got }}</td>
</tr>
</tbody>
</table>
</div>
<h4 class="mcp-sub">使用要点</h4>
<ul class="mcp-notes">
<li><b>文件怎么给</b>:直接在话里写服务器可读的绝对路径(如 <code>/home/pics/图.png</code>);与站点同机的 AI 助手传本机路径即可,无需先上传。</li>
<li><b>结果怎么拿</b>:文本类结果 AI 会直接念给你;文件类结果返回 <code>url</code> 下载链接(带同款令牌访问),可让 AI 转发给你。</li>
<li><b>一次说清</b>:目标语言、尺寸、格式等要求直接写在话里(如「翻译成英文」「放大两倍」「转成 Word」),AI 会作为参数传给工具。</li>
<li><b>随时可换</b>:删掉旧令牌重新生成,改一下客户端配置里的 Bearer 值即可,不影响其它客户端。</li>
</ul>
<h4 class="mcp-sub">排错速查</h4>
<div class="mcp-trouble">
<div v-for="t in mcpTroubles" :key="t.code" class="mcp-trouble-row">
<code class="mcp-code">{{ t.code }}</code>
<span>{{ t.fix }}</span>
</div>
</div>
</n-card>
<!-- ===== 工具清单 ===== -->
<n-card class="mcp-card" title="⑤ 可调用的 13 个工具" :bordered="true">
<div class="mcp-tools-grid">
<div v-for="t in mcpTools" :key="t.name" class="mcp-tool-item">
<code class="mcp-code">{{ t.name }}</code>
<span class="mcp-tool-desc">{{ t.desc }}</span>
</div>
</div>
</n-card>
<!-- ===== 注意事项 ===== -->
<n-card class="mcp-card" title="⑥ 注意事项" :bordered="true">
<ul class="mcp-notes">
<li>令牌即授权凭证:<b>不要公开分享</b>;泄露后在上方删除该令牌,重新生成即可作废旧令牌。</li>
<li>卡密过期或授权被撤销后,令牌<b>立即失效</b>(调用返回 401),续费激活后自动恢复。</li>
<li>每次调用都会记录在管理后台「MCP 调用」中(令牌尾号 / 工具 / 耗时 / 结果),便于对账与排错。</li>
<li>文件类工具(ocr / tts / 视频等)请传<b>服务器可读的文件路径</b>;与站点同机的 AI 助手直接传本机绝对路径即可,结果中的 <code>url</code> 为下载地址(需带同款令牌访问)。</li>
<li>生图、文档翻译等为慢操作(可达数分钟),客户端 timeout 建议 ≥ 600 秒。</li>
</ul>
</n-card>
</n-spin>
</div>
</template>
<style scoped lang="less">
.mcp-page {
display: flex;
flex-direction: column;
gap: 16px;
text-align: left;
}
.mcp-card {
border-radius: 10px;
}
.mcp-h {
display: flex;
align-items: center;
gap: 8px;
font-weight: 600;
}
.mcp-buy {
display: flex;
flex-direction: column;
gap: 12px;
}
.mcp-buy-row {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
}
.mcp-row {
display: flex;
align-items: center;
gap: 12px;
padding: 6px 0;
flex-wrap: wrap;
}
.mcp-label {
min-width: 64px;
color: var(--n-text-color-3, #888);
font-size: 13px;
}
.mcp-code {
background: rgba(128, 128, 128, 0.12);
border-radius: 6px;
padding: 2px 8px;
font-family: var(--n-font-family-mono, monospace);
font-size: 13px;
word-break: break-all;
}
.mcp-hint {
color: var(--n-text-color-3, #999);
font-size: 12px;
}
.mcp-gen-row {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
margin-bottom: 12px;
}
.mcp-tokens-scroll {
overflow-x: auto;
}
.mcp-table {
width: 100%;
min-width: 760px;
border-collapse: collapse;
font-size: 13px;
}
.mcp-table th,
.mcp-table td {
border-bottom: 1px solid rgba(128, 128, 128, 0.18);
padding: 8px 10px;
text-align: left;
white-space: nowrap;
}
.mcp-tok-cell {
display: flex;
align-items: center;
gap: 8px;
}
.mcp-empty {
padding: 24px 0;
}
.mcp-codeblock {
position: relative;
background: rgba(128, 128, 128, 0.1);
border-radius: 8px;
padding: 14px 16px;
}
.mcp-codeblock pre {
margin: 0;
white-space: pre-wrap;
word-break: break-all;
font-size: 13px;
line-height: 1.6;
}
.mcp-copy-btn {
position: absolute;
top: 8px;
right: 8px;
}
.mcp-note {
margin: 10px 0 0;
font-size: 13px;
color: var(--n-text-color-2, #666);
}
.mcp-tools-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
gap: 10px;
}
.mcp-tool-item {
display: flex;
align-items: baseline;
gap: 10px;
padding: 8px 10px;
border: 1px solid rgba(128, 128, 128, 0.16);
border-radius: 8px;
}
.mcp-tool-desc {
font-size: 12px;
color: var(--n-text-color-2, #666);
}
.mcp-auth-ok {
padding: 8px 14px;
margin-bottom: 12px;
border-radius: 8px;
background: rgba(16, 186, 128, 0.12);
border: 1px solid rgba(16, 186, 128, 0.35);
color: #059669;
font-size: 13.5px;
font-weight: 600;
}
.mcp-primary {
margin-bottom: 14px;
padding: 12px 14px;
border-radius: 10px;
border: 1px dashed rgba(37, 99, 235, 0.5);
background: rgba(37, 99, 235, 0.05);
}
.mcp-primary-label {
font-size: 13px;
font-weight: 600;
margin-bottom: 8px;
}
.mcp-primary-body {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
}
.mcp-primary-token {
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
font-size: 13.5px;
word-break: break-all;
user-select: all;
padding: 6px 10px;
border-radius: 6px;
background: rgba(128, 128, 128, 0.12);
flex: 1;
min-width: 260px;
}
.mcp-steps {
display: flex;
flex-direction: column;
gap: 8px;
margin-bottom: 6px;
}
.mcp-step {
padding: 8px 12px;
background: rgba(128, 128, 128, 0.07);
border-radius: 8px;
font-size: 13.5px;
line-height: 1.7;
}
.mcp-sub {
margin: 16px 0 8px;
font-size: 14px;
font-weight: 600;
}
.mcp-say {
color: #2563eb;
white-space: normal;
min-width: 260px;
}
.mcp-trouble {
display: flex;
flex-direction: column;
gap: 8px;
}
.mcp-trouble-row {
display: flex;
align-items: baseline;
gap: 12px;
font-size: 13px;
line-height: 1.7;
}
.mcp-trouble-row .mcp-code {
flex: none;
}
.mcp-notes {
margin: 0;
padding-left: 20px;
display: flex;
flex-direction: column;
gap: 8px;
font-size: 13.5px;
line-height: 1.7;
}
</style>
+12
View File
@@ -0,0 +1,12 @@
import { Plug } from '@vicons/tabler';
import { defineTool } from '../tool';
import { translate } from '@/plugins/i18n.plugin';
export const tool = defineTool({
name: translate('tools.mcp-connect.title'),
path: '/mcp-connect',
description: translate('tools.mcp-connect.description'),
keywords: ['mcp', 'ai', 'llm', 'claude', 'hermes', 'agent', 'api', 'token', '接入', '智能体', '大模型'],
component: () => import('./McpConnect.vue'),
icon: Plug,
});