HL🌱数字花园

手搓 mcp 发送 qq 邮件的功能（使用 cherrystudio），看千遍不如实践一遍 - 开发调优 - LINUX DO

7分钟阅读

效果演示

向大模型索要数据，并自动发送到指定邮箱

最后收到邮件的结果截图

先推荐 2 个 mcp 网站

mcp 中文文档：MCP 协议：AI 时代的上下文集成革命 – MCP 中文站（Model Context Protocol 中文）
mcp server 收录站：https://mcp.so/ mcp 服务器收录站：https://mcp.so/

手搓的配套视频我放到文章底部

前置准备

我这边以 node 来做演示，node js 环境点此下载，这个一定要有，没有现场装，啪的一下很快

// 检查node环境
node -v
// 检查npm环境
npm -v
// 检查npx环境
npx -v
// 配置淘宝源
npm config set registry https://registry.npmmirror.com

初始化 mcp 项目

# 创建一个文件夹（可手动创建）
mkdir first-mcp-server
cd first-mcp-server
 # 初始化 npm 项目
npm init -y
 # 安装mcp sdk依赖
npm install @modelcontextprotocol/sdk @anthropic-ai/sdk dotenv
npm install -D typescript @types/node
 # 创建 TypeScript 配置
npx tsc --init
 # 创建必要的文件
mkdir src
touch src/index.ts

加入如下代码

#!/usr/bin/env node
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
    ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";

const server = new Server({
  name: "first-mcp-server",
  version: "0.0.1",
}, {
  capabilities: {
    tools: {}
  }
});

// List available tools 一定要有，否则无法接入mcp-client
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
      tools: [
          {
              name: "测试方法",
              description: "这是一个测试方法描述",
              inputSchema: {
                  type: "object",
                  properties: {
                      property1: {
                          type: "string",
                          description: "属性1",
                      },
                      property2: {
                          type: "string",
                          description: "属性2",
                      },
                      property3: {
                          type: "number",
                          description: "属性3，非必填",
                      },
                  },
                  required: ["property1", "property2"],
              },
          },
      ],
  };
});

// 启动服务
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error("First MCP Server running on stdio");
}

// 异常捕获
main().catch((error) => {
  console.error("Fatal error in main():", error);
  process.exit(1);
});

tsconfig.json 改为如下

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"]
}

package.json 加入如下代码

{
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node build/client.js"
  }
}

编译构建

打开命令行执行 npm run build，构建后会生成build/index.js文件

cherry-studio接入

注意：cherry-studio需要安装 bun 和 uv，否则可能会报错

点击保存后会与你的 mcp - 代码建立连接，连接完成如下：

如果你做到了和我上面一样，那么接下来我们来实现发邮件的功能，代码如下：

#!/usr/bin/env node
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
    ListToolsRequestSchema,
    CallToolRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
import * as nodemailer from 'nodemailer';

const server = new Server({
  name: "email-mcp-server",
  version: "0.0.1",
}, {
  capabilities: {
    tools: {}
  }
});

// 环境变量配置
const EMAIL_HOST = process.env.EMAIL_HOST || 'smtp.qq.com';
const EMAIL_PORT = parseInt(process.env.EMAIL_PORT || '465');
const EMAIL_USER = process.env.EMAIL_USER;
const EMAIL_PASS = process.env.EMAIL_PASS;

if (!EMAIL_USER || !EMAIL_PASS) {
  console.error("EMAIL_USER or EMAIL_PASS environment variable is not set");
  process.exit(1);
}

// 创建邮件传输器
const transporter = nodemailer.createTransport({
  host: EMAIL_HOST,
  port: EMAIL_PORT,
  secure: true,
  auth: {
    user: EMAIL_USER,
    pass: EMAIL_PASS,
  },
});

// List available tools 一定要有，否则无法接入mcp-client
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
      tools: [
          {
              name: "send-email",
              description: "发送邮件，支持HTML内容、表格和附件",
              inputSchema: {
                  type: "object",
                  properties: {
                      to: {
                          type: "string",
                          description: "收件人邮箱，多个收件人用逗号分隔",
                      },
                      cc: {
                          type: "string",
                          description: "抄送邮箱，多个抄送用逗号分隔",
                      },
                      subject: {
                          type: "string",
                          description: "邮件主题",
                      },
                      html: {
                          type: "string",
                          description: "邮件HTML内容，支持表格等HTML标签",
                      },
                      attachments: {
                          type: "array",
                          description: "附件列表",
                          items: {
                              type: "object",
                              properties: {
                                  filename: { type: "string" },
                                  path: { type: "string" }
                              }
                          }
                      }
                  },
                  required: ["to", "subject", "html"],
              },
          },
      ],
  };
});

// 处理发送邮件请求
server.setRequestHandler(CallToolRequestSchema, async (request) => {
    try {
        if (!request.params.name || !request.params.arguments) {
            return {
                success: false,
                error: "Tool name and arguments are required"
            };
        }
        if (request.params.name === "send-email") {
            const args = request.params.arguments as {
                to: string;
                cc?: string;
                subject: string;
                html: string;
                attachments?: Array<{ filename: string; path: string }>;
            };

            if (!args.to || !args.subject || !args.html) {
                return {
                    success: false,
                    error: "Required fields missing: to, subject, and html are required"
                };
            }

            const mailOptions = {
                from: EMAIL_USER,
                to: args.to,
                cc: args.cc,
                subject: args.subject,
                html: args.html,
                attachments: args.attachments
            };

            const info = await transporter.sendMail(mailOptions);
            return {
                success: true,
                data: {
                }
            };
        }
        return {
            success: false,
            error: `Unknown tool: ${request.params.name}`
        };
    } catch (error) {
        return {
            success: false,
            error: error instanceof Error ? error.message : "Unknown error occurred"
        };
    }
});

// 启动服务
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error("First MCP Server running on stdio");
}

// 异常捕获
main().catch((error) => {
  console.error("Fatal error in main():", error);
  process.exit(1);
});

这里增加了一个发送邮件的nodemailer依赖，所以需要 npm 安装一下
npm install --save @types/nodemailer

然后再次执行构建 npm run build，构建后去cherry-studio简单修改下属性点击保存

这里有几个参数我给个示例

EMAIL_HOST=smtp.qq.com
EMAIL_PORT=465
EMAIL_USER=88888888@qq.com
EMAIL_PASS=lrjlmbyslnxxxx

注意EMAIL_PASS需要手动去开启邮箱的 smtp 服务，开启后会有一个码，开启位置如下：

然后问大模型问题就可以了

最后附一下视频：

[视频地址展示不出来，不知道官方允不允许我放出来](【带你快速手搓一个大模型 mcp 服务（小白也能用 cherrystudio 接入）】 带你快速手搓一个大模型 mcp 服务（小白也能用 cherrystudio 接入）_哔哩哔哩_bilibili)

关系图谱