Yahoo Mail MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 LLM 能够与 Yahoo Mail 进行交互。该服务器允许 Claude Desktop 等工具通过安全的 OAuth2 身份验证直接读取、搜索和发送您的 Yahoo 账户邮件。

功能（计划中）

• 读取邮件：从收件箱获取最近的邮件。

• 搜索邮件：使用关键字、发件人或日期搜索特定邮件。

• 发送邮件：使用 Yahoo 的 SMTP 服务器撰写并发送邮件。

先决条件

• Node.js：20 或更高版本。

• Yahoo 开发者应用：您必须在 Yahoo 开发者门户 中创建一个应用以获取 OAuth2 凭据。

为 OAuth2 创建 Yahoo 应用

1. 前往 Yahoo 开发者门户。

2. 创建一个新应用。

3. 将 API 权限 设置为包含 Mail（读写）。

4. 将 重定向 URI 设置为 https://localhost/callback（或您首选的 URI）。

5. 记下您的 客户端 ID (Client ID) 和 客户端密钥 (Client Secret)。

设置

1. 克隆仓库：

   git clone <repository-url>
   cd yahoo-mail-mcp

2. 安装依赖：

   npm install

3. 配置环境变量： 在根目录中创建一个 .env 文件并添加您的 Yahoo 凭据：

   YAHOO_EMAIL=your-email@yahoo.com
   YAHOO_CLIENT_ID=your-client-id
   YAHOO_CLIENT_SECRET=your-client-secret
   YAHOO_REDIRECT_URI=https://localhost/callback

身份验证

首次运行服务器时，它将触发 OAuth2 流程：

1. 浏览器窗口将打开，要求您登录 Yahoo。

2. 授权后，您将被重定向到您的 REDIRECT_URI。

3. 页面可能会加载失败，但这没关系——从地址栏中复制 code 参数。

4. 将该代码粘贴回您的终端。

5. 服务器将使用该代码交换令牌，并将其安全地保存在 .tokens.json 中。

使用方法

开发

使用 vite-node 在开发模式下运行服务器：

npm run dev

构建

构建生产环境项目：

npm run build

与 Claude Desktop 集成

要将此服务器与 Claude Desktop 一起使用，请将其添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "yahoo-mail": {
      "command": "node",
      "args": ["/path/to/yahoo-mail-mcp/dist/index.js"]
    }
  }
}

项目结构

• src/index.ts：MCP 服务器的入口点。

• src/server.ts：MCP 服务器初始化和工具注册。

• src/auth/：OAuth2 流程和令牌管理。

• src/tools/：各个邮件工具的实现。

• src/lib/：IMAP 和 SMTP 连接的辅助库。

许可证

ISC