
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 分