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 分