Which integrations are available for this server?

Retrieves movie and television show ratings and metadata from Douban for identified torrent resources. Provides IMDb ratings and database links for movies and television programs found in search results. Supports torrent discovery and searching through RSS feed integration modes.

How do I use M-Team MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@M-Team MCP Server search for the movie Inception and show me the top results" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

方式二：从源码安装

克隆或下载本项目：

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

安装依赖（使用 uv）：

uv sync

或使用 pip：

pip install -e .

配置 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

Clone or download this project:

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

Install dependencies (with uv):

uv sync

Or with pip:

pip install -e .

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

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

# 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.

M-Team MCP Server

mcp-server-mteam

中文文档

简介

功能列表

安装

前置要求

安装步骤

可选环境变量

在 MCP 客户端中使用

Cursor / Claude Desktop 配置

通过命令行启动

从源码运行

工具文档

`search_torrents` — 搜索种子

`get_torrent_detail` — 获取种子详情

`download_torrent` — 下载种子文件

注意事项

English Documentation

Introduction

Features

Installation

Prerequisites

Steps

Optional Environment Variables

Integration with MCP Clients

Cursor / Claude Desktop

Command line

From source

Tool Reference

`search_torrents` — Search Torrents

`get_torrent_detail` — Get Torrent Details

`download_torrent` — Download Torrent File

License & Disclaimer

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

mcp-server-mteam

中文文档

简介

功能列表

安装

前置要求

安装步骤

可选环境变量

在 MCP 客户端中使用

Cursor / Claude Desktop 配置

通过命令行启动

从源码运行

工具文档

search_torrents — 搜索种子

get_torrent_detail — 获取种子详情

download_torrent — 下载种子文件

注意事项

English Documentation

Introduction

Features

Installation

Prerequisites

Steps

Optional Environment Variables

Integration with MCP Clients

Cursor / Claude Desktop

Command line

From source

Tool Reference

search_torrents — Search Torrents

get_torrent_detail — Get Torrent Details

download_torrent — Download Torrent File

License & Disclaimer

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

`search_torrents` — 搜索种子

`get_torrent_detail` — 获取种子详情

`download_torrent` — 下载种子文件

`search_torrents` — Search Torrents

`get_torrent_detail` — Get Torrent Details

`download_torrent` — Download Torrent File