Outlook SNDS

Outlook SNDS MCP

一个 MCP 服务，可将 Outlook.com Smart Network Data Services (SNDS) REST API 接入 Claude / Cowork / Claude Desktop 和其他任何 MCP 客户端。

使用 Microsoft 账户登录一次即可——服务会通过回环（http://localhost）重定向处理完整的 OAuth 2.0 授权码 + PKCE 流程，缓存令牌并自动刷新。之后只需询问你的 IP 信誉数据。

SNDS 为发件人提供针对每个 IP 的洞察，帮助了解 Outlook.com 如何看待其邮件： 邮件量、投诉率、垃圾邮件过滤器判定、陷阱命中情况，以及封锁／机器人状态。

由 OptiPub 的 Postmaster+ 团队构建并维护。

安装

从发行版安装（推荐）

1. 从最新发行版下载 outlook-snds.mcpb。
2. 在 Cowork / Claude Desktop 中：设置 → 功能 → 安装扩展，选择该文件（也可以直接双击）。
3. 无需配置。

从源代码安装——请参阅构建。

与其他 MCP 客户端配合使用（Cursor、VS Code、Windsurf、…）

.mcpb 只是为 Claude Desktop / Cowork 提供的便捷打包方式。 底层是一个标准的 stdio MCP 服务，因此任何能够运行本地 MCP 服务的客户端都可以直接使用——无需 .mcpb。只需将 客户端指向 server/index.js。

先克隆或下载此仓库，然后添加服务条目：

Cursor — 编辑 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（仅限当前项目）：

{
  "mcpServers": {
    "outlook-snds": {
      "command": "node",
      "args": ["/absolute/path/to/outlook-snds-mcp/server/index.js"]
    }
  }
}

VS Code（.vscode/mcp.json）、Windsurf、Claude Desktop（手动配置）和大多数其他客户端使用相同的 command + args 结构——只有配置文件的位置不同。可选的环境变量覆盖项（参阅配置（可选））应放在 "env": { ... } 对象中。

首次调用工具时会打开浏览器进行 SNDS 登录，与 Cowork 中完全相同——localhost OAuth 回环可在任何本地桌面客户端上运行。

**仅支持远程连接的客户端（例如 Perplexity、ChatGPT 连接器）：**这些客户端只接受远程 HTTPS MCP 服务 URL，不接受本地命令，因此无法直接添加此 stdio 版本。要在这些客户端中使用，必须将其托管为带有基于 Web 的 OAuth 重定向的远程服务。

用法

运行一次 snds_authenticate（浏览器会打开 Microsoft 登录页面），然后：

提问	工具
“让我登录 SNDS”	snds_authenticate
“我已登录 SNDS 吗？”	snds_auth_status
“显示我最新的 SNDS 数据报告”	get_data_report
“2026-12-31 的 SNDS 数据”	get_data_report { date: "2026-12-31" }
“2026-12-31 的 1.2.3.4 的 SNDS 数据”	get_data_report { date: "2026-12-31", ip: "1.2.3.4" }
“有没有被封锁／标记为机器人／丢弃的 IP？”	get_ip_status
“将我从 SNDS 登出”	snds_sign_out

get_data_report 接受可选的 date（yyyy-MM-dd）和可选的 ip （IPv4）。按 IP 筛选时必须提供日期，因为 API 路径为 /api/report/data/{date}/{ip}。

身份验证的工作原理

字段	值
授权	https://login.microsoftonline.com/consumers/oauth2/v2.0/authorize
令牌	https://login.microsoftonline.com/consumers/oauth2/v2.0/token
客户端 ID	a53a6cc1-a1cd-46f7-a4aa-281cdabec33c（SNDS 门户的公共客户端）
范围	a53a6cc1-a1cd-46f7-a4aa-281cdabec33c/.default offline_access openid profile
重定向	http://localhost:<dynamic-port>（环回地址）

登录时，服务会在 127.0.0.1 上启动一个短期 HTTP 监听器，在浏览器中打开 Microsoft 登录页面，在环回 URL 上接收授权码，并使用 PKCE 代码验证器交换令牌。

此仓库不会随附任何密钥。 这是一个使用 PKCE 的公共 OAuth 客户端，因此没有客户端密钥。令牌仅存储在你的计算机上的 ~/.snds-mcp/tokens.json 中，权限为 0600，并且已被 git 忽略。

封装的 REST 端点

基础 URL：https://substrate.office.com/ip-domain-management-snds

• GET /api/report/data/{date?}/{ip?} — IP 数据报告
• GET /api/report/status/ip — IP 状态报告

配置（可选）

所有配置项默认采用 SNDS 门户的值。如有需要，可通过环境变量覆盖：

变量	默认值
SNDS_CLIENT_ID	a53a6cc1-a1cd-46f7-a4aa-281cdabec33c
SNDS_AUTHORITY	https://login.microsoftonline.com/consumers
SNDS_SCOPE	<client-id>/.default offline_access openid profile
SNDS_API_BASE	https://substrate.office.com/ip-domain-management-snds
SNDS_TOKEN_DIR	~/.snds-mcp
SNDS_LOGIN_TIMEOUT_MS	180000
SNDS_REQUEST_TIMEOUT_MS	60000

构建

需要 Node 18+。

npx @anthropic-ai/mcpb validate manifest.json
npx @anthropic-ai/mcpb pack . outlook-snds.mcpb

推送类似 v1.0.0 的标签会触发 CI 执行验证、打包，并自动将 .mcpb 附加到 GitHub Release（参见 .github/workflows/release.yml）。

为什么零依赖

运行时仅使用 Node.js 内置模块（http、https、crypto、 readline）。这样可使软件包保持轻巧（约 11 KB）、消除供应链风险，并且运行时无需执行 npm install。

贡献

欢迎提交 PR 和问题，请参阅 CONTRIBUTING.md。

许可证

MIT © OptiPub

---

与 Microsoft 无关联，也未获得 Microsoft 的认可。“Outlook”、“Outlook.com” 和 “SNDS”是 Microsoft Corporation 的商标。