AI导哈

简历解析与邮件助手

一个基于MCP协议的服务，提供简历解析、邮件通知发送及Next.js前端交互功能，适用于求职辅助和职业发展场景。

  • by ThambimuthuAnush24
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 thambimuthuanush24/mcp-server

使用说明

MCP简历和电子邮件助理

这是一个模型上下文协议（MCP）服务器，提供以下功能：

  1. 简历解析：从简历中分析和提取信息，以回答有关你的专业经验的问题。
  2. 电子邮件通知：发送可自定义收件人、主题和正文的电子邮件通知。
  3. Next.js前端：用于与MCP服务器交互的漂亮、响应迅速的UI。
  4. GitHub页面部署：前端配置为易于部署到GitHub Pages。

现场演示

查看现场演示：https://ThambimuthuAnush24.github.io/mcp-server

项目结构

mcp-server/
├── src/
│   ├── index.ts           # Main MCP server implementation
│   ├── localClient.ts     # Test client for local development
│   ├── services/
│   │   ├── emailService.ts # Email service implementation
│   │   └── resumeService.ts # Resume parsing service
├── frontend/              # Next.js frontend application
│   ├── src/
│   │   ├── app/           # Next.js app directory
│   │   │   ├── api/       # API routes
│   │   │   ├── layout.tsx # Main layout
│   │   │   └── page.tsx   # Main page
│   │   ├── components/    # React components
│   │   └── utils/         # Utility functions
├── .vscode/
│   └── mcp.json           # VS Code MCP integration
├── .env                   # Environment variables (not committed)
├── package.json           # Project dependencies
└── tsconfig.json          # TypeScript configuration

特性

  • 📄 简历分析器：上传和分析简历，智能提取
  • 📧 邮件发送者：轻松创建和发送专业电子邮件
  • 💬 AI助手：获得有关简历和职业的问题的智能答案
  • 🎨 漂亮的UI：具有动画和响应式布局的现代玻璃造型设计
  • 🚀 GitHub页面部署：轻松部署到GitHub页面

使用的技术

  • Next.js 14：用于支持静态导出的前端
  • TypeScript：用于类型安全代码
  • 顺风CSS：追求美观、灵敏的造型
  • 模型上下文协议（MCP）：用于AI驱动的功能
  • GitHub页面：用于部署

先决条件

  • Node.js v18或更高版本
  • npm或纱线
  • Git

安装说明

用于后端开发

  1. 克隆此存储库
  2. 安装依赖项：
    npm install
  3. 创建一个 .env 根目录中包含电子邮件配置的文件
  4. 构建项目：
    npm run build
  5. 启动服务器：
    npm start

用于前端开发

  1. 导航到前端目录：
    cd frontend
  2. 安装依赖项：
    npm install
  3. 启动开发服务器：
    npm run dev
  4. 打开http://localhost:3000在您的浏览器中

GitHub页面部署

此项目已配置为在GitHub Pages上部署。按照以下步骤进行部署：

  1. 请确保您已将代码推送到GitHub：

    git add .
git commit -m "Ready for GitHub Pages deployment"
git push origin main

  2. 运行部署脚本：

    cd frontend
npm run deploy

这将：

  • 构建Next.js应用程序
  • 创建必要的 .nojekyll 文件
  • 部署到gh页面分支
  • 在以下网址提供您的网站https://yourusername.github.io/mcp-server

GitHub页面模式

在GitHub Pages上运行时，应用程序会自动检测环境并使用模拟数据，而不是尝试调用静态部署中不可用的后端API。

提供的MCP工具

  1. parseResume

    • 从文本或PDF解析简历
    • 参数：
      • text （可选）：纯文本简历内容
      • fileContent （可选）：Base64编码的PDF内容
      • fileName （可选）：PDF文件的名称

  2. query恢复

    • 查询已解析的简历数据
    • 参数：
      • query：关于简历要问的问题
      • context （可选）：以前的对话历史记录

  3. send电子邮件

    • 发送电子邮件
    • 参数：
      • to：收件人电子邮件地址
      • subject：电子邮件主题
      • body：电子邮件内容

地方发展

局部测试

后端包括一个用于测试MCP工具的本地客户端：

npm run test:local

调试

要调试MCP服务器：

  1. 在开发模式下运行：

    npm run dev

  2. 检查控制台日志是否有任何错误。

  3. 对于前端调试，请使用浏览器的开发工具。

许可证

麻省理工学院

相关 MCP