{"repo":"PyPtt/ptt_mcp_server","free":true,"listed":false,"github":"https://github.com/PyPtt/ptt_mcp_server","clone":"git clone https://github.com/PyPtt/ptt_mcp_server.git","description":"The best PTT MCP server","language":"Python","stars":38,"topics":["mcp-server","ptt","python3","docker-image"],"license":"BSD-3-Clause","category":"mcp-servers","readme_excerpt":"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 官方文件 進行安裝。 2. 設定 MCP 客戶端 ： 將以下設定加入您的 MCP 客戶端設定檔 (例如： /.gemini/settings.json )。此配置會讓 MCP 客戶端在需要時自動拉取並運行 Docker 容器。 說明： \"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 帳號和密碼。 多帳號設定（選用）： 若您有多組 PTT 帳號，可改用環境變數 PTT ACCOUNTS （格式： 名稱=帳號:密碼 ，多組以逗號分隔）一次設定多組，之後即可用 switch account(\"名稱\") 切換帳號、 list accounts() 查詢可用名稱： 名稱不可含 = 、帳號不可含 : 、密碼不可含 , （PTT 帳密實務上不會用到這些字元）。使用 Docker 時，請在 args 中同時加上 \"-e\", \"PTT ACCOUNTS\" 。原本的單一 PTT ID / PTT PW 設定仍然相容，會自動成為名為 default 的帳號。 3. 啟動與測試 ： 您的 MCP 客戶端現在應該能自動啟動 PTT MCP 伺服器了。您可以嘗試一個簡單的指令來測試連線，例如要求它登入 PTT。 💡 使用範例 (Usage Example) 當您的 MCP 客戶端 (例如 Gemini CLI) 設定完成後，您可以像這樣與 PTT 互動： 您輸入： 幫我登入 PTT MCP 客戶端執行 (背後流程)： 1. Gemini CLI 透過 MCP 協定呼叫 login 功能。 2. ptt-mcp-server 接收到指令，使用 PyPtt 函式庫執行登入。 3. ptt-mcp-server 將登入成功或失敗的結果回傳給 Gemini CLI。 您會看到： 登入成功 ⚙️ 運作原理 (How it Works) 本專案扮演一個中間層的角色。您的 MCP 客戶端 (例如 Gemini CLI 等) 會連線到本機執行的 ptt-mcp-server。伺服器收到指令後，會透過 ","default_branch":null,"files":null,"tree":[],"storefront":"/r/PyPtt","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/PyPtt/ptt_mcp_server/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}