
Personal MCP
io.github.arun250492由 GitHub 帳號 arun250492 發布v2.0.1更新於 Nov 20, 2026
Personal desktop assistant + IsItMe? outage triage (DNS, TLS, HTTP, e-mail auth, cloud status).
概覽
本機 MCP 伺服器,結合故障排查(DNS、TLS、HTTP、郵件驗證、廠商狀態)與個人桌面助理(檔案、Shell、Gmail、行事曆)功能。
- 可以做什麼
- 診斷服務故障,並檢查 DNS 記錄、TLS 憑證、HTTP 回應、郵件驗證與廠商狀態頁
- 檢視本機狀況:系統資訊、IP 位址、磁碟用量、連接埠檢查與 Shell 指令
- 管理檔案與桌面:列出、讀取、寫入、搜尋、移動、刪除檔案,以及剪貼簿、螢幕截圖、開啟應用程式與程序
- 使用 Gmail 與 Google 行事曆:讀取收件匣、寄送郵件、檢視與建立行程
- 發布 Twitter/X 內容、傳送通知與提醒、搜尋並抓取網址,以及日期、計算機與語音朗讀等輔助功能
- 適用情境
- 適合判斷某個網站或服務究竟是全面中斷,還是只有你的網路連不上,並希望取得結論、可能原因與後續處理步驟。也適合想用單一本機伺服器讓助理操作自己電腦、檔案、郵件與行事曆的使用者。
- 執行需求
- 需在本機以 Python 3.10+ 執行,從 personal-mcp-arun 套件安裝,MCP Python SDK 2.x 會自動安裝。Gmail 與行事曆需在 ~/.personal-mcp/gmail_credentials.json 放置 Google OAuth 桌面應用程式憑證檔,或設定 GMAIL_CREDENTIALS_PATH,首次使用時會在瀏覽器登入。可選設定 PERSONAL_MCP_CLOUD_URL 以進行雲端對照;桌面相關功能需安裝 all 附加元件。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Personal MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Personal MCP + IsItMe?
An MCP server that does two jobs:
- IsItMe? — outage triage for IT people. "Is it down, or is it just me?" One call checks DNS, the TLS certificate, the HTTP response and the hosting provider's status page, then returns a verdict, the likely cause, next steps and a ticket-ready summary. Also available as a ChatGPT app.
- Personal desktop assistant. Files, shell, clipboard, screenshots, apps, Gmail, Google Calendar, notifications and more — for Claude Desktop, Claude Code and other local MCP clients.
Install
Python 3.10+. Requires the MCP Python SDK 2.x (installed automatically).
Claude Desktop / Claude Code
Claude Code: claude mcp add personal -- personal-mcp
IsItMe? triage tools
Local vs. cloud view. Run locally, the checks run from your network (and can reach internal hosts). Set
PERSONAL_MCP_CLOUD_URL=https://<your-hosted-isitme> and call diagnose(url, compare_cloud=true) to also run them
from the internet — if it works from the cloud but not from you, the verdict is "your network".
Personal assistant tools
System info, IP addresses, disk usage, port check, shell commands · list/read/write/search/move/delete files · clipboard, screenshots · open URLs, web search, fetch URL · open apps, list/kill processes · Gmail inbox/read/send · Calendar today/upcoming/create · notifications, reminders · Twitter/X post · date/time, calculator, text-to-speech.
Safe mode: set PERSONAL_MCP_SAFE_MODE=1 to not register tools that run commands, write/move/delete files,
kill processes, send e-mail or post to social media.
Gmail/Calendar: put a Google OAuth Desktop app client file at ~/.personal-mcp/gmail_credentials.json
(or set GMAIL_CREDENTIALS_PATH). The first call opens a browser to sign in.
Run modes
--hosted is what powers the ChatGPT app. It never registers personal tools, only checks public internet
addresses on ports 80/443/8080/8443 (private, loopback, link-local and cloud-metadata addresses are refused, and
every connection is pinned to a verified IP to stop DNS-rebinding), rate-limits per client, caches results for 60 s
and logs no checked URLs. Deploy with the included Dockerfile (see PUBLISHING.md).
Development
Tests spin up local HTTPS servers with valid, expiring, expired, wrong-host and self-signed certificates, and exercise the MCP protocol in-process, over streamable HTTP and over stdio.
License
MIT © Arun
來源:README.md,提交 bb3c111
工具
0版本歷史
2- v2.0.1最新Nov 19, 2026
- v1.0.5Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分