mcp-server-mteam

中文 | English

---

中文文档

简介

mcp-server-mteam 是一个基于 FastMCP 框架开发的 MCP（Model Context Protocol）服务器，让 AI 助手（如 Claude、Cursor 等）能够直接调用 M-Team（馒头）私有种子站的 API，实现资源搜索、种子详情获取和种子文件下载功能。

功能列表

工具	说明
search_torrents	按关键词搜索种子资源，支持多种分类模式
get_torrent_detail	根据种子 ID 获取种子详细信息
download_torrent	根据种子 ID 下载 .torrent 文件到本地

安装

前置要求

• Python 3.10 或以上版本（或安装 uv 由 uv 自动管理）
• M-Team 账号及 API Key

安装步骤

方式一：使用 uv 零安装运行（推荐）

uvx mcp-server-mteam

首次运行会自动从 PyPI 拉取并执行，无需手动安装。若需持久安装：

uv tool install mcp-server-mteam

方式二：从源码安装

1. 克隆或下载本项目：

git clone https://github.com/07freedom/mcp-server-mteam.git
cd mcp-server-mteam

2. 安装依赖（使用 uv）：

uv sync

或使用 pip：

pip install -e .

3. 配置 API Key：

复制 .env_example 为 .env，并填入你的 M-Team API Key：

cp .env_example .env

编辑 .env 文件：

MTEAM_API_KEY="your_mteam_api_key_here"

你可以在 M-Team 网站的个人设置 → API Key 处获取 API Key。

可选环境变量

变量名	默认值	说明
MTEAM_API_KEY	（必填）	M-Team API 鉴权密钥
MTEAM_API_BASE	https://api.m-team.cc/api	API 根地址
MTEAM_DOWNLOAD_DIR	./seed	种子文件保存目录

在 MCP 客户端中使用

Cursor / Claude Desktop 配置

在 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "mteam": {
      "command": "uvx",
      "args": ["mcp-server-mteam"],
      "env": {
        "MTEAM_API_KEY": "your_mteam_api_key_here"
      }
    }
  }
}

若从源码运行，可将 command 改为 uv，args 设为 ["run", "mcp-server-mteam"]，或在项目目录下使用 ["run", "/path/to/mcp-server-mteam/server.py"]。也可不在配置中填写 env，在项目目录创建 .env 文件即可。

通过命令行启动

# 使用 uvx（推荐，零安装）
uvx mcp-server-mteam

或

# 项目内运行（需先 uv sync）
uv run mcp-server-mteam

或

# pip 安装后
mcp-server-mteam

从源码运行

uv run python server.py
# 或
uv run mcp-server-mteam

---

工具文档

search_torrents — 搜索种子

搜索 M-Team 上的种子资源。

输入参数

参数	类型	必填	默认值	说明
keyword	string	是	—	搜索关键词，支持中文和英文
mode	string	否	"normal"	搜索模式，可选值见下表
page_number	integer	否	1	页码（从 1 开始）
page_size	integer	否	20	每页结果数（最大 100）

mode 可选值

值	说明
normal	普通资源
adult	成人资源
movie	电影
music	音乐
tvshow	剧集
waterfall	瀑布流
rss	RSS
rankings	排行榜
all	全部

输出示例

Search results for "黑暗骑士" (mode=normal)
Total: 25  |  Page 1, showing 20 items
------------------------------------------------------------
[1125330] The Dark Knight 2008 IMAX UHD BluRay 2160p DDP 5.1 DV HDR x265-hallowed
  Size: 17.74 GB  Seeders: 17  Leechers: 0
  Labels: 中字, 4k, hdr10, DoVi  Discount: PERCENT_50
  IMDB: 9.1  Douban: 9.2
...

---

get_torrent_detail — 获取种子详情

根据种子 ID 获取完整的种子信息。

输入参数

参数	类型	必填	说明
torrent_id	string	是	种子 ID，如 "1125330"

输出示例

Torrent Detail: [1125330]
============================================================
Name       : The Dark Knight 2008 IMAX UHD BluRay 2160p DDP 5.1 DV HDR x265-hallowed
Description: 蝙蝠侠：黑暗骑士崛起|类型: 剧情 / 动作 / 科幻 / 惊悚 / 犯罪
Size       : 17.74 GB  (1 file(s))
Labels     : 中字, 4k, hdr10, DoVi
Discount   : PERCENT_50
Seeders    : 17  Leechers: 0  Completed: 71
Created    : 2026-01-29 15:16:42
Visible    : True  Banned: False
IMDB       : https://www.imdb.com/title/tt0468569/  Rating: 9.1
Douban     : https://movie.douban.com/subject/1851857/  Rating: 9.2

---

download_torrent — 下载种子文件

根据种子 ID 下载 .torrent 文件。

输入参数

参数	类型	必填	说明
torrent_id	string	是	种子 ID，如 "1125330"

输出示例

成功时：

Torrent saved to: /home/user/mcp-server-mteam/seed/[M-TEAM]The.Dark.Knight.2008.IMAX.UHD.BluRay.2160p.DDP.5.1.DV.HDR.x265-hallowed.torrent

失败时：

Failed to get download token: {'code': '403', 'message': 'Forbidden'}

---

注意事项

• 本工具仅供个人学习和合法使用，请遵守 M-Team 的使用条款。
• API Key 属于敏感信息，请勿将 .env 文件提交到公开代码仓库。
• 下载种子功能需要账号有足够的权限。

---

English Documentation

Introduction

M-Team MCP is a FastMCP-based MCP (Model Context Protocol) server that allows AI assistants (Claude, Cursor, etc.) to interact with the M-Team private torrent tracker API — enabling torrent search, detail retrieval, and .torrent file downloads.

Features

Tool	Description
search_torrents	Search torrents by keyword with optional category mode
get_torrent_detail	Get full details for a torrent by its ID
download_torrent	Download a .torrent file to local disk by torrent ID

Installation

Prerequisites

• Python 3.10 or higher (or install uv for automatic management)
• An M-Team account with a valid API Key

Steps

Option 1: Run with uv (no install, recommended)

uvx mcp-server-mteam

On first run, uv will fetch from PyPI and execute without manual install. To install persistently:

uv tool install mcp-server-mteam

Option 2: Install from source

1. Clone or download this project:

git clone https://github.com/07freedom/mcp-server-mteam.git
cd mcp-server-mteam

2. Install dependencies (with uv):

uv sync

Or with pip:

pip install -e .

3. Configure your API Key:

Copy .env_example to .env and fill in your M-Team API Key:

cp .env_example .env

Edit .env:

MTEAM_API_KEY="your_mteam_api_key_here"

You can obtain your API Key from M-Team's user settings page under API Key.

Optional Environment Variables

Variable	Default	Description
MTEAM_API_KEY	(required)	M-Team API authentication key
MTEAM_API_BASE	https://api.m-team.cc/api	API base URL
MTEAM_DOWNLOAD_DIR	./seed	Directory to save downloaded torrent files

Integration with MCP Clients

Cursor / Claude Desktop

Add the following to your MCP client config file:

{
  "mcpServers": {
    "mteam": {
      "command": "uvx",
      "args": ["mcp-server-mteam"],
      "env": {
        "MTEAM_API_KEY": "your_mteam_api_key_here"
      }
    }
  }
}

For source install, use "command": "uv" with "args": ["run", "mcp-server-mteam"], or ["run", "/path/to/mcp-server-mteam/server.py"] in the project directory. You can also omit env and use a .env file in the project directory.

Command line

# With uvx (recommended, no install)
uvx mcp-server-mteam

or

# From project (after uv sync)
uv run mcp-server-mteam

or

# After pip install
mcp-server-mteam

From source

uv run python server.py
# or
uv run mcp-server-mteam

---

Tool Reference

search_torrents — Search Torrents

Search for torrents on M-Team by keyword.

Input Parameters

Parameter	Type	Required	Default	Description
keyword	string	Yes	—	Search keyword (Chinese or English)
mode	string	No	"normal"	Search mode (see table below)
page_number	integer	No	1	Page number (1-based)
page_size	integer	No	20	Results per page (max 100)

Available mode Values

Value	Description
normal	General resources
adult	Adult content
movie	Movies
music	Music
tvshow	TV shows
waterfall	Waterfall view
rss	RSS
rankings	Rankings
all	All categories

Example Output

Search results for "The Dark Knight" (mode=movie)
Total: 25  |  Page 1, showing 20 items
------------------------------------------------------------
[1125330] The Dark Knight 2008 IMAX UHD BluRay 2160p DDP 5.1 DV HDR x265-hallowed
  Size: 17.74 GB  Seeders: 17  Leechers: 0
  Labels: 中字, 4k, hdr10, DoVi  Discount: PERCENT_50
  IMDB: 9.1  Douban: 9.2
...

---

get_torrent_detail — Get Torrent Details

Retrieve full information for a specific torrent.

Input Parameters

Parameter	Type	Required	Description
torrent_id	string	Yes	Torrent ID, e.g. "1125330"

Example Output

Torrent Detail: [1125330]
============================================================
Name       : The Dark Knight 2008 IMAX UHD BluRay 2160p DDP 5.1 DV HDR x265-hallowed
Description: 蝙蝠侠：黑暗骑士崛起|类型: 剧情 / 动作 / 科幻 / 惊悚 / 犯罪
Size       : 17.74 GB  (1 file(s))
Labels     : 中字, 4k, hdr10, DoVi
Discount   : PERCENT_50
Seeders    : 17  Leechers: 0  Completed: 71
Created    : 2026-01-29 15:16:42
Visible    : True  Banned: False
IMDB       : https://www.imdb.com/title/tt0468569/  Rating: 9.1
Douban     : https://movie.douban.com/subject/1851857/  Rating: 9.2

---

download_torrent — Download Torrent File

Download a .torrent file for the given torrent ID.

Input Parameters

Parameter	Type	Required	Description
torrent_id	string	Yes	Torrent ID, e.g. "1125330"

Example Output

On success:

Torrent saved to: /home/user/mcp-server-mteam/seed/[M-TEAM]The.Dark.Knight.2008.IMAX.UHD.BluRay.2160p.DDP.5.1.DV.HDR.x265-hallowed.torrent

On failure:

Failed to get download token: {'code': '403', 'message': 'Forbidden'}

---

License & Disclaimer

• This project is for personal and lawful use only. Please comply with M-Team's Terms of Service.
• Your API Key is sensitive — never commit your .env file to a public repository.
• Torrent downloads require sufficient account privileges on M-Team.