简历查询与邮件发送服务

一个基于模型上下文协议(MCP)的服务,提供简历查询和邮件发送功能,支持Docker部署和本地开发。

  • by Yasela-dissanayake
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 yasela-dissanayake/mcp-cv-email-demo

使用说明

MCP CV+电子邮件服务器

该项目实现了 模型上下文协议(MCP)服务器 这可以:

  • 通过以下方式回答有关简历的问题 cv.query
  • 通过发送电子邮件(为安全起见,采用模拟运行模式) email.send
  • 通过Docker+超级网关+Railway部署为实时MCP服务

实时部署

公共MCP URL(部署在铁路上):
👉 https://mcp-cv-email-demo-production.up.railway.app/mcp

此端点说话 流式HTTP (SSE帧)。


地方发展

1.克隆并安装

git clone git@github.com:Yasela-dissanayake/mcp-cv-email-demo.git
cd mcp-cv-email
npm install

2.本地运行(开发模式)

npm run dev

这将通过ts节点(stdio)运行MCP服务器。

3.使用Docker运行

塑造形象:

docker build -t mcp-cv-email:latest .

运行容器:

docker run --rm -p 9090:8080   -e PORT=8080   -e DRY_RUN=true   -e ALLOWED_RECIPIENTS="you@example.com,hr@example.com"   mcp-cv-email:latest

服务器将在以下位置可用:

  • SSE 端点 : http://localhost:9090/sse
  • 邮件POST: http://localhost:9090/message
  • 可流式传输的HTTP端点: http://localhost:9090/mcp

卷曲测试

所有请求都必须发送 Accept: application/json, text/event-stream 头球

1.列出可用工具

curl -N -X POST https://mcp-cv-email-demo-production.up.railway.app/mcp   -H 'Content-Type: application/json'   -H 'Accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":"1","method":"tools/list"}'

2.查询简历

curl -N -X POST https://mcp-cv-email-demo-production.up.railway.app/mcp   -H 'Content-Type: application/json'   -H 'Accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":"2","method":"tools/call","params":{"name":"cv.query","arguments":{"question":"What role did I have at my last position?"}}}'

3.发送电子邮件(模拟运行)

curl -N -X POST https://mcp-cv-email-demo-production.up.railway.app/mcp   -H 'Content-Type: application/json'   -H 'Accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":"3","method":"tools/call","params":{"name":"email.send","arguments":{"recipient":"you@example.com","subject":"Hello","body":"Test"}}}'

环境变量

  • PORT → 监听端口(铁路自动注入)。默认为 8080 当地。
  • DRY_RUN → If true,电子邮件仅模拟(建议用于演示)。
  • ALLOWED_RECIPIENTS → 以逗号分隔的允许电子邮件地址列表。

作者

Yasela Dissanayake
全栈开发人员•React和Node.js•在AI和Web3中成长