mcp-server-mteam

中文 | English

中文文档

简介

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

功能列表

安装

前置要求

• 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。

可选环境变量

在 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 上的种子资源。

输入参数

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/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

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

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

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