MCP Media Server

MCPAI代理

提供方 neal3000

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

MCP媒体服务器是一个用于列出和播放媒体文件的服务器和客户端,支持stdio、HTTP和HTTPS传输协议,兼容Claude Desktop。

一句话选型结论

按资料字段整理

MCP Media Server 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

媒体播放Python本地部署文件管理跨平台HTTP服务Claude集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Media Server当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方neal3000上游标注的维护方 neal3000
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.0 KB
来自项目仓库与上游目录的原文,未做删改

MCP媒体服务器

一个用于列出和播放媒体文件的模型上下文协议(MCP)服务器和客户端 ~/Media/MOVIES支持stdio、HTTP和HTTPS传输协议,与Claude Desktop兼容。

特点

  • 列出电影浏览您“电影”目录中的所有媒体文件
  • 播放电影使用系统默认媒体播放器开始播放
  • 多种运输方式stdio(用于Claude桌面版)、HTTP和HTTPS
  • 跨平台在Linux上运行(之后也支持macOS和Windows)

安装```bash

Install dependencies

pip install -r requirements.txt

Or install individually

pip install mcp starlette uvicorn sse-starlette


## 快速入门

### 服务器

**stdio(针对Claude桌面版):**```bash
python media_server.py --transport stdio

HTTP:(超文本传输协议)```bash
python media_server.py --transport http --host 0.0.0.0 --port 3000


**HTTPS:**
没有内置的HTTPS(无论怎么说)使用Caddy作为反向代理来处理HTTPS,并将HTTP请求转发到media_server````bash

### Client

**List movies via stdio:**
```bash
python media_client.py --protocol stdio --command list````

**通过标准输入输出流播放电影:**

```bash
python media_client.py --protocol stdio --command play --movie "example.mp4"```

**通过HTTP列出电影:**

```bash
python media_client.py --protocol http --url http://localhost:3000/sse --command list```

**通过HTTPS播放电影:**

```bash
python media_client.py --protocol https --url https://localhost:3001/sse \
--command play --movie "example.mp4"```

## 用于https的代理服务器(或:https的代理)

pi5c.example.com:3001 {
tls /etc/caddy/certs/fullchain.pem /etc/caddy/certs/privkey.pem
reverse_proxy localhost:3000
}```

在我的情况下,“pi5c.example.com”是一个具有本地IP的公共DNS条目。肯定有更好的方法,
但目前它还能用。

我有一个针对 *.example.com 的通配符证书,我已经将其复制到本地
将证书复制到 /etc/caddy/certs/ 目录(如果该目录不存在,请先创建),并将所有者更改为 caddy

mkdir -p /etc/caddy/certs
cp /etc/letsencrypt/live/example.com/fullchain.pem /etc/caddy/certs/
cp /etc/letsencrypt/live/example.com/privkey.pem /etc/caddy/certs/
chown caddy:caddy /etc/caddy/certs/*
chmod 644 /etc/caddy/certs/fullchain.pem
chmod 600 /etc/caddy/certs/privkey.pem```

## 配置

### 媒体目录

默认情况下,服务器会在 `~/Media/MOVIES`要更改这一点,请编辑 `MEDIA_DIR` 变量在 `media_server.py`:

```python
MEDIA_DIR = Path.home() / "Media" / "MOVIES"```

### 支持的文件类型

支持以下视频格式:

- .mp4, .mkv, .avi, .mov, .wmv, .flv, .webm, .m4v, .mpg, .mpeg(这些是视频文件的常见扩展名,翻译为中文即:.mp4、.mkv、.avi、.mov、.wmv、.flv、.webm、.m4v、.mpg、.mpeg)

要添加更多格式,请编辑 `MEDIA_EXTENSIONS` 设定为 `media_server.py`。

## Claude桌面集成

添加到您的Claude桌面配置中(`claude_desktop_config.json`):

```json
{
"mcpServers": {
"media-server": {
"command": "python",
"args": ["/path/to/media_server.py", "--transport", "stdio"]
}
}
}```

## n8n 集成

未经测试
对于 n8n,请使用 HTTP 或 HTTPS 传输方式:

1. 使用HTTP/HTTPS传输启动服务器
1. 在 n8n 中,使用 HTTP 请求节点来连接到 `http://your-server:8000/sse`
1. 使用POST请求来 `/messages` MCP通信的端点

## 媒体播放器要求

服务器将自动检测并使用可用的媒体播放器:

**Linux:**

- MPV(多用途汽车)`mpv`这是唯一一个能可靠运行的播放器
- VLC(`vlc`)
- MPlayer(`mplayer`)
- 或系统默认(`xdg-open`)

**macOS:**

- 用途 `open` 命令(系统默认播放器)

**Windows:**

- 用途 `os.startfile()` (系统默认播放器)

### 安装播放器(Linux)

```bash
# Ubuntu/Debian
sudo apt install vlc

# Fedora
sudo dnf install vlc

# Arch
sudo pacman -S vlc```

## API 参考文档

### 工具

#### 列出电影

列出Movies目录中的所有媒体文件。

**参数:** 无

**返回值:** 包含电影名称、路径、大小和文件类型的列表

**示例:**

```json
{
"name": "list_movies",
"arguments": {}
}```

#### 播放电影

使用系统默认的媒体播放器播放特定的电影。

**参数:**

- `filename` (字符串,必填):电影文件的名称

**返回值:** 状态消息,指示成功或错误

**示例:**

```json
{
"name": "play_movie",
"arguments": {
"filename": "example.mp4"
}
}```

## 服务器命令行选项

usage: media_server.py [-h] [--transport {stdio,http,https}] [--host HOST]
[--port PORT] [--certfile CERTFILE] [--keyfile KEYFILE]

optional arguments:
--transport {stdio,http}
Transport protocol to use (default: stdio)
--host HOST Host to bind to for HTTP/HTTPS (default: 127.0.0.1)
--port PORT Port to bind to for HTTP/HTTPS (default: 8000)```

客户端命令行选项

usage: media_client.py [-h] --protocol {stdio,http,https} --command {list,play}
[--movie MOVIE] [--url URL] [--server-script SERVER_SCRIPT]

optional arguments:
--protocol {stdio,http,https}
Protocol to use for connecting to server
--command {list,play}
Command to execute (list or play)
--movie MOVIE        Movie filename to play (required for 'play' command)
--url URL            Server URL for HTTP/HTTPS (e.g., http://localhost:8000/sse)
--server-script SERVER_SCRIPT
Path to server script for stdio (default: media_server.py)```

## 故障排除

### 未找到媒体播放器

安装MPV或其他支持的媒体播放器:

```bash
sudo apt install mpv  # Linux```

### HTTP/HTTPS 连接错误

- 检查服务器是否正在运行
- 验证URL中是否包含 `/sse` 终端节点
- 对于HTTPS,请确保证书文件有效

### 权限错误

确保 `~/Media/MOVIES` 目录存在且可读:

```bash
mkdir -p ~/Media/MOVIES
chmod 755 ~/Media/MOVIES

安全注意事项

  • 服务器仅访问配置的媒体目录中的文件
  • 服务器不会修改或删除任何文件

许可证

MIT 许可证 - 欢迎根据需要自由使用和修改。
```

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Media Server 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

MCP Media Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Media Server 收费吗?

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

MCP Media Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Media Server 支持哪些客户端?

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

MCP Media Server 能提供哪些能力?

资料显示能力标签包括 跨平台、Python、Claude、HTTP服务。具体工具清单以官方文档为准。

MCP Media Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

MCP Media Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。