
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 分