
Propresenter Mcp
io.github.alxpark由 GitHub 账号 alxpark 发布v1.0.1更新于 Oct 24, 2026
ProPresenter 7 MCP server
概览
本地 MCP 服务器,通过 ProPresenter 7 的 REST API 让助手控制演示、播放列表、音频、媒体、计时器、消息、外观和录制
- 可以做什么
- 查看状态与信息:版本、屏幕状态、当前幻灯片、系统时间、录制状态与编码、遮罩与主题及幻灯片详情、舞台布局与当前舞台消息,以及当前外观或活动播放列表和演示。控制演示与幻灯片:按 UUID 触发演示、跳到下一张或指定编号幻灯片、播放时间线、获取和弦谱与幻灯片缩略图,以及播放、暂停、跳过或定位各图层。管理播放列表、资料库、音频与媒体:列出并聚焦播放列表、触发条目、播放下一首歌曲、列出资料库并从中触发演示、触发媒体条目。操作公告、外观、宏、道具、消息、计时器与触发器
- 适用场景
- 适合在礼拜或活动现场使用 ProPresenter 7 时,通过助手以对话方式操作:查看当前播出内容、切换幻灯片、启动计时器或录制、显示舞台消息,而无需在软件界面中手动点击。
- 运行要求
- 需要 Node.js 18 或更高版本并本地构建该包;ProPresenter 7 需运行并启用 Network API,且在网络中可访问。设置 PROPRESENTER_URL(默认 API 设有密码则设置 PROPRESENTER_PASSWORD。仅支持桌面端。
安装
在 SourceWeft 中
- 打开 控制台中的 Propresenter Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
propresenter-mcp
A comprehensive Model Context Protocol (MCP) server that provides complete control over ProPresenter presentations via the ProPresenter API. This server implements the full ProPresenter API specification with 231 endpoints organized into 27 API groups and exposed through modular client classes.
Official MCP Registry
Prerequisites
- Node.js 18 or higher
- ProPresenter 7 with API enabled
- ProPresenter running and accessible on your network
Installation
-
Clone this repository or download the source code
-
Install dependencies:
- Build the project:
Configuration
The server connects to ProPresenter using environment variables:
PROPRESENTER_URL- The URL of your ProPresenter instance (default:http://localhost:50000)PROPRESENTER_PASSWORD- The API password (if configured in ProPresenter)
ProPresenter Setup
- Open ProPresenter preferences
- Go to the Network tab
- Enable "Network" and note the port number (default: 50000)
- Optionally set a password for API access
Usage
With Claude Desktop
Add this to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Replace /absolute/path/to/propresenter-mcp with the actual path to this project.
With VS Code
This server can be debugged directly in VS Code using the included MCP configuration.
- Open this project in VS Code
- The server is automatically configured for debugging via
.vscode/mcp.json - Use the MCP extension to test and debug the server
Example Commands
Once connected, you can ask Claude to control ProPresenter:
Status & Information:
- "What version of ProPresenter is running?"
- "Show me the status of all screens"
- "What's the status of audience screens?"
- "Get the current slide information"
Presentations:
- "What presentation is currently active?"
- "Trigger the presentation with UUID [uuid]"
- "Go to the next slide"
- "Go to slide number 5"
- "Play the presentation timeline"
- "Show me the chord chart"
- "Get a thumbnail of slide 3"
Announcements:
- "What announcement is currently active?"
- "Trigger the next announcement cue"
- "Show me the announcement timeline status"
- "Go to announcement cue 2"
Audio & Media:
- "List all audio playlists"
- "Show me the contents of audio playlist [id]"
- "Play the next song in the active playlist"
- "Trigger the focused audio playlist"
- "List all media playlists"
- "Trigger media item [id] in playlist [playlist_id]"
Playlists:
- "List all presentation playlists"
- "Show me the active playlist"
- "Focus the next playlist"
- "Trigger the first item in the focused playlist"
- "Create a new playlist called 'Sunday Service'"
Capture:
- "What's the current capture status?"
- "Start recording"
- "Stop the capture"
- "Show me available capture encodings for RTMP"
Clear:
- "Clear the announcements layer"
- "Show me all clear groups"
- "Trigger the clear group [id]"
- "Create a new clear group"
Library:
- "List all my libraries"
- "Show presentations in library [id]"
- "Trigger presentation [id] from library [library_id]"
Looks:
- "Show me all configured looks"
- "What look is currently live?"
- "Switch to look [id]"
- "Create a new look"
Macros:
- "List all macros"
- "Trigger macro [id]"
- "Show me all macro collections"
- "Create a new macro"
Props:
- "List all props"
- "Trigger prop [id]"
- "Clear prop [id]"
- "Pause auto-clear for prop [id]"
- "List all prop collections"
Stage:
- "Show me the current stage message"
- "Display stage message [message]"
- "Hide the stage message"
- "List all stage layouts"
- "Set stage layout [layout_id] for screen [screen_id]"
Messages:
- "Show me all messages"
- "Display message [id]"
- "Hide message [id]"
- "Create a new message"
Timers:
- "List all timers"
- "Start timer [id]"
- "Stop timer [id]"
- "Reset the sermon timer"
- "Create a countdown timer"
- "Get the current system time"
Themes:
- "List all themes"
- "Show me details of theme [id]"
- "Get theme slide [slide_id] from theme [theme_id]"
Transport:
- "Play the presentation layer"
- "Pause the audio layer"
- "Skip forward 30 seconds on the announcement layer"
- "Go to the end of the presentation"
- "Get the current playback time"
Masks:
- "List all masks"
- "Show me details of mask [id]"
Triggers:
- "Trigger the next cue"
- "Trigger the previous media item"
Development
Build
Watch Mode
API Reference
This server implements the complete ProPresenter API documented at https://openapi.propresenter.com/
API Coverage
- Total Endpoints: 231 REST API endpoints
- API Groups: 27 functional groups
- Client Modules: 18 TypeScript client classes
- Tool Definitions: 18 MCP tool modules
- Handler Modules: 18 request handler modules
- HTTP Methods: Full support for GET, POST, PUT, DELETE operations
- Architecture: Complete three-layer implementation (clients → tools → handlers)
See api/api.md for complete API documentation with all 231 endpoints organized by group.
Troubleshooting
Connection Issues:
- Verify ProPresenter is running and the API is enabled
- Check that the URL and port are correct
- Ensure no firewall is blocking the connection
- Verify the password if authentication is enabled
Server Not Starting:
- Make sure you've built the project with
npm run build - Check that Node.js 18+ is installed
- Verify all dependencies are installed with
npm install
来源:README.md,提交 31832fe
工具
0版本历史
1- v1.0.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分