M-Team MCP Server

M-Team MCP Server

中文 | English

中文文档

简介

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

功能列表

安装

前置要求

• Python 3.10 或以上版本
• M-Team 账号及 API Key

安装步骤

方式一：从 PyPI 安装（推荐）

pip install mteam-mcp

方式二：从源码安装

1. 克隆或下载本项目：

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

2. 安装依赖：

pip install -r requirements.txt

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。

可选环境变量

在 MCP 客户端中使用

Cursor / Claude Desktop 配置

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

{
  "mcpServers": {
    "mteam": {
      "command": "mteam-mcp",
      "env": {
        "MTEAM_API_KEY": "your_mteam_api_key_here"
      }
    }
  }
}

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

通过命令行启动（pip 安装后）

mteam-mcp

或

python -m mteam_mcp

从源码运行

fastmcp run server.py:mcp
# 或
python server.py

工具文档

search_torrents — 搜索种子

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

输入参数

mode 可选值

输出示例

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 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 saved to: /home/user/mteam-mcp/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 Server 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

Installation

Prerequisites

• Python 3.10 or higher
• An M-Team account with a valid API Key

Steps

Option 1: Install from PyPI (recommended)

pip install mteam-mcp

Option 2: Install from source

1. Clone or download this project:

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

2. Install dependencies:

pip install -r requirements.txt

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

Integration with MCP Clients

Cursor / Claude Desktop

Add the following to your MCP client config file:

{
  "mcpServers": {
    "mteam": {
      "command": "mteam-mcp",
      "env": {
        "MTEAM_API_KEY": "your_mteam_api_key_here"
      }
    }
  }
}

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

Command line (after pip install)

mteam-mcp

or

python -m mteam_mcp

From source

fastmcp run server.py:mcp
# or
python server.py

Tool Reference

search_torrents — Search Torrents

Search for torrents on M-Team by keyword.

Input Parameters

Available mode Values

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

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

Example Output

On success:

Torrent saved to: /home/user/mteam-mcp/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.