axios-ai-mail MCP Server

关键词

LLM助手本地上下文服务工具调用邮件工作流上下文管理

使用说明（Markdown格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP（Model Context Protocol）的服务端，用于向大语言模型（LLM）提供邮件相关的资源、工具以及提示模板，支持资源读取、工具调用和提示渲染等核心能力，并通过简单的CLI入口与REST网关进行集成。

  • 主要功能点

    • MCP 服务端核心：提供基于 FastMCP 的工具注册与执行，允许LLM客户端通过 MCP 调用后端工具完成操作。
    • 资源和工具：通过 axios-ai-mail 的后端服务暴露账户、邮件、标签等资源，并注册 list_accounts、search_emails、read_email、compose_email、send_email、mark_read、delete_email 等工具。
    • 提示模板/模板渲染：通过 AI 分类器、DFSL 等机制生成提示并驱动工具执行。
    • API网关对接：MCP 客户端通过 axios-ai-mail 的 REST API 进行资源访问与操作执行。
    • 多传输协议兼容：设计上支持 STDIO（通过 CLI 启动）、WebSocket 等传输渠道，方便与不同类型的客户端集成。
    • 会话与状态管理：通过后端数据库和状态管理（如同步状态、任务队列、推送通知等）实现上下文的一致性。

  • 安装与运行

    • 先确保后端服务就绪（数据库、网络、外部依赖如 Ollama、Gmail/IMAP 等按需配置）。
    • 通过命令行启动 MCP 服务：
      • axios-ai-mail mcp
    • MCP 服务将基于 STDIO 传输工作，LLM 客户端通过配置连接到该 MCP 服务器，进行工具调用与上下文获取。

  • 服务器配置（MCP 客户端侧配置示例，JSON 格式） 说明：该配置用于占位说明，实际客户端需按照 MCP 客户端连接要求填写。仓库中 MCP 服务端名称为 customer 端可识别的服务器标签，连接方式为 STDIO。 { "server": "axios-ai-mail", "command": "axios-ai-mail", "args": ["mcp"] } 注释：server 为 MCP 客户端在 UI/LLM 配置中引用的服务器名称；command 为启动命令；args 为启动时传入的参数数组，确保 MCP 客户端能通过该配置正确启动并连接 MCP 服务。

  • 基本使用方法

    • 启动 MCP 服务端后，LLM 客户端可以通过标准 MCP 调用接口，向服务器请求工具清单、执行工具、以及读取/渲染 Prompt 模板。
    • 客户端示例场景：
      • 查询可用工具、查询账户信息、读取邮件、编写并发送草稿、对邮件进行分类与标记等操作。
    • 运行与调试要点：
      • 确保后端的 REST API 服务可用（用于 MCP 工具调用的后端网关）。
      • 确认前端/LLM 客户端能够通过配置文件正确启动并连接 MCP 服务器。

服务器信息

访问项目