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).

已驗證STDIO僅桌面效率與工作流安全與監控

概覽

AI 產生的概覽

本機 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 附加元件。
安裝前請注意
預設模式會註冊可執行 Shell 指令、寫入、移動與刪除檔案、終止程序、寄送郵件及發布社群內容的工具;設定 PERSONAL_MCP_SAFE_MODE=1 可不予註冊。Gmail 與行事曆存取依賴存放在磁碟上的 Google OAuth 憑證檔。HTTP 模式在本機監聽並開放全部工具;只有託管模式才僅限唯讀檢查。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Personal MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Personal MCP + IsItMe?

An MCP server that does two jobs:

  1. 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.
  2. Personal desktop assistant. Files, shell, clipboard, screenshots, apps, Gmail, Google Calendar, notifications and more — for Claude Desktop, Claude Code and other local MCP clients.

[IsItMe verdict card]

Install

bash
pip install personal-mcp-arun            # core + IsItMe? triage toolspip install "personal-mcp-arun[all]"     # + Gmail/Calendar, desktop (psutil, clipboard, screenshots), Twitter/X

Python 3.10+. Requires the MCP Python SDK 2.x (installed automatically).

Claude Desktop / Claude Code

json
{  "mcpServers": {    "personal": { "command": "personal-mcp" }  }}

Claude Code: claude mcp add personal -- personal-mcp

IsItMe? triage tools

ToolWhat it does
diagnose(url)One-shot outage diagnosis with a verdict card: DNS + TLS + HTTP + provider status, likely cause, fixes, ticket summary
check_dns(name, record_types)A/AAAA/CNAME/MX/TXT/NS/CAA/SOA from Google + Cloudflare DNS (and your own resolver locally), consistency check
check_tls(url)Certificate expiry, hostname match, issuer, chain trust, protocol
check_http(url)Status, redirect chain, latency, CDN headers, explanations of 5xx / Cloudflare 52x
check_email_auth(domain)MX, SPF (incl. 10-lookup limit), DMARC policy, DKIM under common selectors
vendor_status(vendors)Live status of AWS, Azure, GCP, Cloudflare, GitHub, Slack, Jira, Zoom, Vercel, Netlify, OpenAI, …

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

bash
personal-mcp             # stdio (default) — all toolspersonal-mcp --http      # streamable HTTP on 127.0.0.1:8000 — all tools, local clients onlypersonal-mcp --hosted    # public server on 0.0.0.0:$PORT — ONLY the read-only IsItMe? tools

--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

bash
pip install -e ".[dev]"pytest -q

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
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v2.0.1最新Nov 19, 2026
  2. v1.0.5Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分