Frank MCP 个人简历服务器

简介

Frank MCP 个人简历服务器是一个基于 FastMCP 协议构建的微服务，主要用于提供个人简历数据和相关功能。该服务器实现了多个工具（Tool），包括获取个人资料、技能列表、搜索简历内容以及获取媒体资源链接等。

实现的工具

以下是 Frank MCP 个人简历服务器实现的主要工具：

• get_profile: 获取个人基本资料。
• get_skills: 获取个人技能列表。
• search_cv: 搜索简历中的特定内容。
• get_company_experience: 获取指定公司的工作经历。
• get_resume_link: 获取个人简历 PDF 文件的下载链接。
• get_picture_link: 获取个人头像图片文件的下载链接。

项目结构

该服务器基于 Node.js 和 Bun 语言构建，主要包含以下部分：

1. Server: 使用 Bun 构建的 HTTP 服务，监听端口 3001，并提供标准输入输出（stdio）和 Server-Sent Events（SSE）两种连接方式。
2. Tools: 实现了上述提到的各种工具（Tool），每个工具对应一个独立的函数或模块。
3. Resources: 提供了一些静态资源，包括个人简历 PDF 文件和头像图片文件。

项目配置

项目的根目录下包含以下关键文件：

• package.json: Node.js 和 Bun 的依赖管理文件。
• Dockerfile: 用于 Docker 容器构建的配置文件。
• mcp.json: 配置 MCP 服务器的信息，包括连接方式和环境变量。

使用示例

连接到 MCP 服务

通过 CLI 客户端连接：

# 通过 stdio 模式连接
npx fastmcp dev "bun run start"

# 通过 SSE 模式连接
npx fastmcp connect http://localhost:3001/sse

在 Cursor 中配置：

1. 打开 Cursor，进入设置界面。
2. 点击左侧边栏的“功能”选项。
3. 滚动到“MCP 服务器”部分。
4. 点击“添加新的 MCP 服务”按钮。
5. 填写以下信息：
   • 服务名称：frank-cv-mcp
   • 对于 stdio 模式：
     • 类型：command
     • 命令：bun run start
   • 对于 SSE 模式：
     • 类型：url
     • URL：http://localhost:3001/sse
6. 点击“保存”。

使用 mcp.json 配置：

{
  "mcpServers": {
    "frank-cv-stdio": {
      "command": "bun",
      "args": ["run", "start"],
      "env": {
        "NODE_ENV": "development"
      }
    },
    "frank-cv-sse": {
      "url": "http://localhost:3001/sse"
    }
  }
}

请求流程示例

获取基本信息：

// 获取个人资料
const profile = await client.callTool("get_profile", {});

// 获取技能列表
const skills = await client.callTool("get_skills", {});

// 获取简历的 Markdown 格式文档
const cvMarkdown = await client.accessResource("cv://frankgoortani");

搜索特定经历：

// 搜索 AI 相关经验
const aiExperience = await client.callTool("search_cv", {
  query: "ai"
});

// 获取指定公司的工作经历
const uberExperience = await client.callTool("get_company_experience", {
  company: "Uber"
});

获取媒体链接：

// 获取简历 PDF 下载链接
const resumeLink = await client.callTool("get_resume_link", {});

// 获取头像图片下载链接
const pictureLink = await client.callTool("get_picture_link", {});

Docker 使用

该项目可以打包为 Docker 镜像，适用于 Synology NAS 或其他容器编排平台。

先决条件

• 已安装 Docker 在您的系统上。

构建 Docker 镜像：

1. 切换到项目根目录（包含 Dockerfile 的位置）。

2. 运行以下命令构建镜像，如果需要可以修改镜像名称：

   docker build -t cv-mcp .
   

运行 Docker 容器：

1. 构建完成后，运行容器：

   docker run -d -p 8080:3001 --name cv-mcp frank_cv_mcp