PTTSAFE

English Version

PTT MCP Server

The best MCP server for Ptt. Proudly built by PyPtt developer.

📖 專案介紹 (Description)

本專案是一個 PTT MCP (Model Context Protocol) 伺服器,它基於功能強大的 `PyPtt` 函式庫。這使得您的 MCP 客戶端能夠真正登入 PTT 並透過 MCP 協定與 PTT 批踢踢實業坊進行實際互動,並實現自動化操作。

🚀 快速開始 (Quick Start)

使用 Docker 部署 PTT MCP Server 是最推薦的方式,它提供了環境隔離和簡化的設定。

1. 安裝 Docker:

如果您的系統尚未安裝 Docker,請參考 Docker 官方文件 進行安裝。

1. 設定 MCP 客戶端:

將以下設定加入您的 MCP 客戶端設定檔 (例如:~/.gemini/settings.json)。此配置會讓 MCP 客戶端在需要時自動拉取並運行 Docker 容器。

{
"mcpServers": {
"PTT": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "PTT_ID",
"-e", "PTT_PW",
"ghcr.io/pyptt/ptt_mcp_server:latest"
],
"env": {
"PTT_ID": "YOUR_PTT_ID", // 請換成您自己的 PTT 帳號
"PTT_PW": "YOUR_PTT_PW"  // 請換成您自己的 PTT 密碼
}
}
}
}

說明:

• "command": "docker": 指示 MCP 客戶端使用 docker 命令來啟動伺服器。
• "args": 包含 docker run 命令的參數。
• -i: 保持標準輸入 (stdin) 開啟,以便 MCP 伺服器可以接收指令。
• --rm: 容器停止後自動刪除,保持系統整潔。
• -e PTT_ID 和 -e PTT_PW: 告訴 Docker 將 PTT_ID 和 PTT_PW 環境變數傳遞給容器。
• ghcr.io/pyptt/ptt_mcp_server:latest: 指定要運行的 Docker 映像檔。
• "env": 將 PTT_ID 和 PTT_PW 直接設定為環境變數。請務必替換為您自己的 PTT 帳號和密碼。

**多帳號設