返回 MCP 目录
public公开dns本地运行

jmap-mcp-server

JMAP-MCP是一个连接器,用于通过MCP协议与JMAP服务器交互,实现读取邮件功能,支持Fastmail等服务器。

article

README

🚀 JMAP - MCP

JMAP - MCP 是一个用于通过模型上下文协议(MCP)读取电子邮件的连接器,能与 JMAP(JSON 邮件访问协议)服务器进行交互,为您提供便捷的邮件读取体验。

🚀 快速开始

JMAP - MCP 是一个专门设计用于与 JMAP(JSON 邮件访问协议)服务器进行交互的连接器,它让您能够通过模型上下文协议(MCP)读取电子邮件。此项目特别展示了与 Fastmail JMAP 服务器的集成。

✨ 主要特性

  • 作为连接器与 JMAP 服务器交互。
  • 支持通过 MCP 协议读取电子邮件。
  • 可与 Fastmail JMAP 服务器集成。

📦 安装指南

本地开发

  1. 前提条件:确保您已安装 Node.js。
  2. 克隆仓库:将此仓库克隆到您的本地机器。
  3. 安装依赖:导航到项目目录并运行以下命令:
npm install

📚 详细文档

MCP 配置

要使用 JMAP - MCP,您需要在 MCP 配置文件中将其配置为 mcpServer。以下是一个配置示例:

{
  "mcpServers": {
    "emails": {
      "command": "npx",
      "args": ["-y", "@jahfer/jmap-mcp-server"],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session", // 示例
        "JMAP_TOKEN": "<your-jmap-token>"
      }
    }
  }
}

API 令牌配置

您需要设置 JMAP API 令牌以与您的电子邮件服务器(如 Fastmail)进行身份验证。从您服务器的设置中获取 API 令牌。 在运行应用程序时设置 JMAP_SESSION_URLJMAP_TOKEN 环境变量。

工具使用

在 MCP 中完成配置后,您可以使用 MCP 内与服务器定义进行交互的命令或功能,通过 JMAP 协议读取您的电子邮件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端