Skip to main content
Glama
TnZzZHlp

mteam-mcp

by TnZzZHlp
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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 仅通过环境变量传入。

Related MCP server: Torrent Search MCP Server

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

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TnZzZHlp/mteam-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server