简历聊天与邮件通知服务器

一个基于模型上下文协议(MCP)的服务器,支持AI助手查询简历内容并发送邮件通知,适用于人才展示和技术能力演示场景。

  • by WANehan923
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 wanehan923/mcp-server

使用说明

Nehan Chandira的CV MCP服务器

一个模型上下文协议(MCP)服务器,使人工智能助手能够讨论Nehan Chandira的简历并发送电子邮件通知。该项目通过实际实施展示了API的设计和集成技能。

特性

CV聊天功能

  • 智能简历解析:从简历内容中提取结构化数据
  • 自然语言查询:问以下问题:
    • “你在上一个职位上扮演什么角色?”
    • “你的技术技能是什么?”
    • “告诉我你最近的项目”
    • “你的教育背景是什么?”

电子邮件通知系统

  • SMTP集成:通过可配置的电子邮件服务发送电子邮件
  • 输入验证:使用Zod模式进行稳健验证
  • 错误处理:全面的错误消息和状态报告
  • HTML电子邮件模板:专业电子邮件格式

Next.js游乐场

  • 交互式前端:测试简历聊天和电子邮件功能
  • 现代用户界面:采用Tailwind CSS的简洁、响应式设计
  • 实时聊天界面:模拟MCP服务器交互
  • 电子邮件模板:常见用例的预构建模板

技术栈

  • 后端:TypeScript、Node.js、MCP SDK
  • 电子邮件服务:支持Gmail/SMTP的Nodemailer
  • 验证:Zod用于模式验证
  • 前端:Next.js 14、React、顺风CSS
  • 构建工具:TypeScript编译器,TSX用于开发

先决条件

  • Node.js 18+和npm
  • Gmail帐户(用于电子邮件功能)
  • MCP兼容的人工智能助手(克劳德桌面等)

安装和设置

1.克隆和安装依赖项

# Navigate to project directory
cd "New MCP Serever"

# Install server dependencies
npm install

# Install frontend dependencies (optional)
cd frontend && npm install && cd ..

2.配置电子邮件服务

创建一个 .env 根目录中的文件:

EMAIL_USER=your-email@gmail.com
EMAIL_APP_PASSWORD=your-app-password

电子邮件设置说明:

  1. 在您的Gmail帐户上启用双因素身份验证
  2. 生成特定于应用程序的密码:
    • 转到Google帐户设置
    • 安全→ 2-步骤验证→ 应用密码
    • 为“邮件”生成密码
  3. 将生成的密码用作 EMAIL_APP_PASSWORD

3.构建服务器

npm run build

用法

作为MCP服务器

  1. 启动服务器:

    npm start
    # or for development
    npm run dev
    
  2. 在Claude桌面中配置 (claude_desktop_config.json):

    {
      "mcpServers": {
        "nehan-cv-server": {
          "command": "node",
          "args": ["/path/to/New MCP Serever/dist/index.js"]
        }
      }
    }
    
  3. 在Claude Desktop中使用:

    • 询问有关Nehan简历的问题
    • 通过MCP工具发送电子邮件

Next.js游乐场(可选)

cd frontend
npm run dev

访问 http://localhost:3000 进入互动游乐场。

🔧 可用的MCP工具

cv_chat

谈谈Nehan的背景和经历。

参数:

  • question (string):关于简历内容的问题

例子:

{
  "question": "What programming languages does Nehan know?"
}

send_email

向指定收件人发送电子邮件通知。

get_cv_topics

获取您可以询问的可用简历主题。

参数: 无

email_service_info

获取电子邮件服务配置详细信息。

参数: 无

实时部署

快速部署

后端(MCP服务器):

前端(游乐场):

🔗 预期的实时URL

部署后,您将拥有:

  • 后端: https://your-app-name.railway.app
  • 前端: https://your-project.vercel.app

📖 详细的部署指南:参见 docs/DEPLOYMENT_LINKS.md 获取分步说明

📞 联系


该项目展示了在现代web开发、API集成和基于云的解决方案方面的技术熟练程度。为潜在雇主和合作者展示软件工程能力而构建。