mcp-server-mteam
中文文档
简介
mcp-server-mteam 是一个基于 FastMCP 框架开发的 MCP(Model Context Protocol)服务器,让 AI 助手(如 Claude、Cursor 等)能够直接调用 M-Team(馒头)私有种子站的 API,实现资源搜索、种子详情获取和种子文件下载功能。
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Launch方式一:使用 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 sync
或使用 pip:
pip install -e .
复制 .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 客户端配置文件中添加:
{
"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'}
.env 文件提交到公开代码仓库。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.
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
git clone https://github.com/07freedom/mcp-server-mteam.git
cd mcp-server-mteam
uv sync
Or with pip:
pip install -e .
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.
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 omitenvand use a.envfile in the project directory.
# 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
uv run python server.py
# or
uv run mcp-server-mteam
search_torrents — Search TorrentsSearch 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 DetailsRetrieve 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 FileDownload 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'}
.env file to a public repository.mcp-server-mteam is a FastMCP-based MCP
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
MCP Server Mteam runs locally over stdio.
Last checked 2026-10-26. mcp-server-mteam is a FastMCP-based MCP