mteam-mcp

面向 Hermes Agent 的 M-Team MCP Server。通过标准 stdio MCP 提供种子查询、详情查看和 .torrent 文件下载功能。

工具

MCP 工具	功能
search_torrents	按关键词、分区、分类、优惠、编码和存活状态查询种子，返回 AI 易读的 Markdown
get_torrent_detail	根据数字种子 ID 获取详情和做种状态，返回 AI 易读的 Markdown
download_torrent	生成临时下载令牌并将 .torrent 文件保存到本地目录

下载令牌只在进程内部使用，不会返回给模型。M-Team API Key 仅通过环境变量传入。

API 环境

本项目默认并直接使用 M-Team 正式环境 API：

https://api.m-team.cc/api

除非显式覆盖 MTEAM_API_BASE，客户端始终连接正式环境。

Markdown 输出格式

search_torrents 和 get_torrent_detail 都返回 Markdown 文本，而不是直接把原始 API JSON 交给模型。

搜索结果包含：

• 查询词、模式、当前页、每页数量、总结果和总页数
• 种子 ID、名称、大小、做种人数、下载人数、优惠和标签
• 查看详情、下载以及翻到下一页的明确调用提示

详情结果包含：

• 基本信息：种子 ID、名称、分类、大小、文件数量、发布时间和标签
• 简介
• 活跃状态：做种、下载、完成人次、可见状态和禁用状态
• 优惠状态
• IMDb、豆瓣等合法外部链接
• download_torrent 的调用参数提示

M-Team 返回的标题、简介和标签会进行 Markdown 转义，并标记为外部元数据，避免被误当成系统操作指令。底层客户端仍保留结构化字典，因此不会影响下载和内部处理。

Hermes Agent 配置

需要先安装 uv。将以下内容加入 ~/.hermes/config.yaml：

mcp_servers:
  mteam:
    command: "uvx"
    args:
      - "--from"
      - "git+https://github.com/TnZzZHlp/mteam-mcp.git"
      - "mteam-mcp"
    env:
      MTEAM_API_KEY: "你的 API Key"
      MTEAM_API_BASE: "https://api.m-team.cc/api"
      MTEAM_DOWNLOAD_DIR: "~/.hermes/downloads/mteam"
      MTEAM_TIMEOUT: "30"
      MTEAM_MAX_TORRENT_BYTES: "33554432"
    enabled: true
    timeout: 120
    connect_timeout: 30
    supports_parallel_tool_calls: false
    tools:
      include: [search_torrents, get_torrent_detail, download_torrent]
      resources: false
      prompts: false

修改后执行：

hermes mcp test mteam

然后在 Hermes 会话中运行：

/reload-mcp

Hermes 注册后的工具名为：

mcp_mteam_search_torrents
mcp_mteam_get_torrent_detail
mcp_mteam_download_torrent

本地运行

git clone https://github.com/TnZzZHlp/mteam-mcp.git
cd mteam-mcp
uv sync
MTEAM_API_KEY='你的 API Key' uv run mteam-mcp

也可以复制环境变量模板：

cp .env.example .env

本项目不会自动读取 .env。启动前应由 shell、systemd、容器或 Hermes 的 env 配置注入变量。

环境变量

变量	必填	默认值	说明
MTEAM_API_KEY	是	无	M-Team API Key
MTEAM_API_BASE	否	https://api.m-team.cc/api	正式环境 API 根地址
MTEAM_DOWNLOAD_DIR	否	~/.hermes/downloads/mteam	.torrent 保存目录
MTEAM_TIMEOUT	否	30	HTTP 超时秒数
MTEAM_MAX_TORRENT_BYTES	否	33554432	单个种子文件最大字节数

查询参数示例

Hermes 可调用：

{
  "keyword": "The Dark Knight",
  "mode": "normal",
  "page_number": 1,
  "page_size": 20,
  "visible": 1,
  "categories": [],
  "discount": "FREE"
}

visible：

• 1：活种
• 2：死种
• null：不筛选

开发和测试

uv sync --extra dev
uv run pytest -q

安全说明

• 不要把真实 API Key 写入仓库、命令历史、日志或聊天内容。
• download_torrent 不会把临时下载 URL 返回给模型。
• 临时下载请求不会携带 x-api-key，避免重定向到其他域名时泄露密钥。
• 下载采用临时文件后原子替换，并限制最大文件大小。
• 仅用于你有权访问和下载的内容，并遵守站点规则及当地法律。

License

MIT