Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Mineru Tianshu

天枢 - 企业级 AI 一站式数据预处理平台 | PDF/Office转Markdown | 支持MCP协议AI助手集成 | Vue3+FastAPI全栈方案 | 文档解析 | 多模态信息提取

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit 46af54c0fd72, unchanged since the check below.

PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    backend/litserve_worker.py, line 805 shutil.rmtree(dest)

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    setup.sh, line 996 if curl -fsS "http://localhost:${api_port}/api/v1/health" > /dev/null 2>&1; then

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    AGENTS.md, line 76 └── .env.example # 根环境变量模板(docker-compose 与 Makefile 消费)

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    backend/mcp_server.py, line 54 TIANSHU_API_KEY = os.getenv("TIANSHU_API_KEY", "")

  • OBFUSCATION_FILE_OVER_READ_CAP Note

    A file was over the read cap and was not fully read.

    frontend/package-lock.json, line 1 {

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    backend/litserve_worker.py, line 805

    shutil.rmtree(dest)

    backend/litserve_worker.py, line 809

    shutil.rmtree(actual_output)

    backend/litserve_worker.py, line 1048

    subprocess.run(timeout=...) 只杀直接子进程。libreoffice 会派生 soffice.bin,

    Show more

    backend/litserve_worker.py, line 1057

    proc = subprocess.Popen(cmd, **popen_kwargs)

    backend/litserve_worker.py, line 1213

    shutil.rmtree(extract_dir, ignore_errors=True)

    backend/litserve_worker.py, line 1232

    shutil.rmtree(extract_dir, ignore_errors=True)

    backend/start_all.py, line 65

    api_proc = subprocess.Popen([sys.executable, "api_server.py"], cwd=Path(__file__).parent, env=env)

    backend/start_all.py, line 98

    worker_proc = subprocess.Popen(worker_cmd, cwd=Path(__file__).parent, env=worker_env)

    backend/start_all.py, line 121

    scheduler_proc = subprocess.Popen(scheduler_cmd, cwd=Path(__file__).parent)

    backend/start_all.py, line 139

    mcp_proc = subprocess.Popen([sys.executable, "mcp_server.py"], cwd=Path(__file__).parent, env=mcp_env)

    backend/task_db.py, line 638

    shutil.rmtree(rp)

    backend/remove_watermark/pdf_watermark_handler.py, line 330

    shutil.rmtree(temp_dir)

    backend/utils/doc_decrypt.py, line 56

    shutil.rmtree(dest_dir, ignore_errors=True)

    backend/video_engines/keyframe_extractor.py, line 371

    shutil.rmtree(temp_dir)

    backend/video_engines/video_engine.py, line 190

    result = subprocess.run(

    backend/video_engines/video_engine.py, line 461

    result = subprocess.run(["ffmpeg", "-version"], stdout=subprocess.PIPE, stderr=subprocess.PIPE, timeout=5)

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    setup.sh, line 996

    if curl -fsS "http://localhost:${api_port}/api/v1/health" > /dev/null 2>&1; then

    setup.sh, line 1012

    if curl -fsS "http://localhost:${frontend_port}/api/v1/health" > /dev/null 2>&1; then

    setup.sh, line 1103

    token=$(curl -fsS -X POST "http://localhost:${api_port}/api/v1/auth/login" -H "Content-Type: application/json" -d "$login_body" 2> /dev/null | json_field access_token)

    Show more

    setup.sh, line 1112

    submit_resp=$(curl -fsS -X POST "http://localhost:${api_port}/api/v1/tasks/submit" -H "Authorization: Bearer ${token}" -F "file=@${sample}" 2> /dev/null)

    setup.sh, line 1124

    resp=$(curl -fsS "http://localhost:${api_port}/api/v1/tasks/${task_id}" -H "Authorization: Bearer ${token}" 2> /dev/null)

    setup.sh, line 1401

    if curl -fsS "http://localhost:${api_port}/api/v1/health" > /dev/null 2>&1; then

    setup.sh, line 1406

    if curl -fsS "http://localhost:${worker_port}/health" > /dev/null 2>&1; then

    setup.sh, line 1411

    if curl -fsS "http://localhost:${frontend_port}/" > /dev/null 2>&1; then

    backend/mineru_pipeline/engine.py, line 150

    with urllib.request.urlopen(health_url, timeout=2) as response:

    dify_plugin/tianshu/provider/tianshu.py, line 72

    response = httpx.get(test_url, headers=headers, timeout=10.0)

    scripts/docker-entrypoint.sh, line 197

    if curl -f -s "$service_url" > /dev/null 2>&1; then

    frontend/src/views/ApiDocsScalar.vue, line 267

    const response = await fetch(`${window.location.origin}/api/v1/openapi.json`)

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    AGENTS.md, line 76

    └── .env.example # 根环境变量模板(docker-compose 与 Makefile 消费)

    AGENTS.md, line 103

    cp .env.example .env # 必需!backend/.env 缺失时 start_all.py 直接退出

    backend/mcp_server.py, line 54

    TIANSHU_API_KEY = os.getenv("TIANSHU_API_KEY", "")

    Show more

    CLAUDE.md, line 37

    cp .env.example .env # REQUIRED - start_all.py exits if backend/.env is missing

    setup.sh, line 9

    # bash setup.sh --mode cpu # Mac CPU 本地开发(.env.cpu + compose.cpu)

    setup.sh, line 18

    # --yes 跳过全部交互提问,未指定的配置保持 .env 默认值

    setup.sh, line 21

    # --smoke-only 不部署,只对已启动的服务跑一次解析自检(配合 --mode 选 .env 文件)

    setup.sh, line 22

    # --port N 解析自检访问的 API 端口(默认读 .env 的 API_PORT)

    setup.sh, line 27

    # bash setup.sh --mode gpu --dry-run # 预览 .env 与执行计划

    backend/mcp_server.py, line 57

    MCP_API_KEYS = [key.strip() for key in os.getenv("MCP_API_KEYS", "").split(",") if key.strip()]

    backend/redis_queue.py, line 58

    password=os.getenv("REDIS_PASSWORD") or None,

    backend/redis_queue.py, line 59

    queue_key=os.getenv("REDIS_QUEUE_KEY", "tianshu:task_queue"),

    backend/redis_queue.py, line 60

    processing_key=os.getenv("REDIS_PROCESSING_KEY", "tianshu:processing"),

    backend/auth/auth_db.py, line 208

    admin_password = os.getenv("TIANSHU_ADMIN_PASSWORD", "")

    backend/auth/jwt_handler.py, line 18

    JWT_SECRET_KEY = os.getenv("JWT_SECRET_KEY", "")

    backend/auth/sso.py, line 271

    "client_secret": os.getenv("SSO_CLIENT_SECRET"),

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    frontend/package-lock.json, line 1

    {

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 46af54c0fd72. can delete files. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: 46af54c0fd72d3363bd7c3b36c95fd1c0e8f46da

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen