Mteam MCP MCP Server安装配置 GitHub与使用方法

选型结论

Mteam MCP 属于搜索检索类 MCP Server，公开资料标注 3 个工具，通过stdio 本地进程接入，适配 Claude Desktop、Claude、Cursor，有可以直接复制的安装命令；接入前要先准备 API Key。

分类

搜索检索

传输方式

stdio

认证方式

API Key

部署方式

公开资料未说明

安装与配置

安装命令

uvx mcp-server-mteam

客户端配置示例

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

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 3 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

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

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.

工具与能力

工具数量

3

资源数量

0

提示词数量

0

能力标签

种子搜索Python本地部署资源管理API集成私有种子站MCP服务器

支持客户端

Claude DesktopClaudeCursor

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

查资料带出处

把网页、论文和文档的检索结果连同链接一起带回对话。

站内知识检索

在自己的文档库里做语义搜索，比关键词更贴题。

事实核对

交叉多个来源确认一条信息，减少模型凭记忆作答。

选择建议

值得选的地方

只提供 3 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
已经适配 Claude Desktop、Claude、Cursor，换客户端不用重新研究配置。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
需要自备API Key，没有凭据没法直接试。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在搜索检索场景里让模型直接调用外部能力的人。
已经在用 Claude Desktop 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
暂时拿不到API Key的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Mteam MCP MCP World · 本页	3	stdio	有	1 个	2026-05-17
Baidu Netdisk MCP World	未标注	未说明	未标注	1 个	2026-05-17
Sequentialthinking MCP.so	1	SSE	有	2 个	2026-05-17
Brave Search 433812ff MCP World	2	未说明	未标注	1 个	2026-05-17
mindsdb (430e18) MCP World	0	未说明	有	1 个	2026-05-17

常见问题

5 条

Mteam MCP 怎么安装？

公开资料给出的安装命令是 uvx mcp-server-mteam，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Mteam MCP 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

Mteam MCP 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Mteam MCP 需要 API Key 吗？

公开资料标注的认证方式是API Key，也就是要先拿到凭据才能连上；凭据只填在自己本地的配置里，不要写进公开仓库。

Mteam MCP 支持哪些客户端？

公开资料标注支持 Claude Desktop、Claude、Cursor；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP World

mteam-mcp

一个基于FastMCP框架的MCP服务器，允许AI助手通过API访问M-Team私有种子站，实现资源搜索、详情获取和种子文件下载。

www.mcpworld.com

/detail/1466e482c97c2457d9656a518ee3311c

参考链接

仓库入口

github.com

/07freedom/mteam-mcp

来源标签

种子搜索Python本地部署资源管理API集成私有种子站MCP服务器

来源分类路径

种子搜索

继续浏览同类 MCP

更多搜索检索 MCP（7,303）返回 MCP 目录

上一个 MCP

MSSQL SERVER WEBAPP

Natural Language SQL Chat Interface using MCP SQL Server

下一个 MCP

Mtg MCP 6172c39e

基于Swift实现的魔法风云会(MTG)卡牌管理服务器，提供牌组管理和卡牌搜索功能。

选型结论

安装与配置

详细介绍

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

工具与能力

典型使用场景

选择建议

同类对比

常见问题

Mteam MCP 怎么安装？

Mteam MCP 怎么在 Claude Desktop、Cursor 里配置？

Mteam MCP 收费吗？

Mteam MCP 需要 API Key 吗？

Mteam MCP 支持哪些客户端？

来源信息

继续浏览同类 MCP

`search_torrents` — 搜索种子

`get_torrent_detail` — 获取种子详情

`download_torrent` — 下载种子文件

`search_torrents` — Search Torrents

`get_torrent_detail` — Get Torrent Details

`download_torrent` — Download Torrent File