返回市场
示例候选MCP服务器

示例候选MCP服务器

作者:jhgaylor3 星标更新:2025-05-05

项目介绍

支持MCP的HTTP服务器

一个使用Express和TypeScript构建的HTTP服务器,同时提供网页服务和Model Context Protocol (MCP)端点。

功能

  • 具备网页和MCP功能的HTTP服务器
  • 使用现代流式HTTP传输实现无状态MCP服务器
  • 使用TypeScript确保类型安全
  • 使用Express.js处理HTTP请求

需求

  • Node.js 18+
  • npm 或 yarn

安装

# 克隆仓库(或下载)
git clone https://github.com/your-username/example-candidate-mcp-server.git
cd example-candidate-mcp-server

# 安装依赖
npm install

# 启动http传输
npm run start:web

# 启动stdio传输
npm run start

自定义候选人数据

要自定义候选人数据,可以在环境变量中设置以下环境变量,或者在项目根目录下的.env文件中设置:

  • CONTACT_EMAIL: 服务器的联系电子邮件地址。
  • MAILGUN_API_KEY: 用于发送邮件的Mailgun API密钥。
  • MAILGUN_DOMAIN: 用于发送邮件的Mailgun域名。
  • CANDIDATE_NAME: 候选人的姓名。
  • RESUME_URL: 候选人简历的PDF格式URL。
  • LINKEDIN_URL: 候选人LinkedIn个人资料的URL。
  • GITHUB_URL: 候选人GitHub个人资料的URL。
  • WEBSITE_URL: 候选人个人网站的URL。

这些变量用于配置服务器,并自定义由MCP服务器提供的候选人的信息。更改这些变量后,请重启服务器以使更改生效。

您也可以直接在src/config.ts中更新它们。

开发

# 构建TypeScript代码
npm run build

# 在开发模式下运行并自动重新加载
npm run dev

# 运行测试(当添加时)
npm test

服务器结构

src/
  ├── index.ts                # 主应用程序入口点
  ├── express.ts              # HTTP服务器配置
  ├── stdio.ts                # STDIO服务器配置
  ├── config.ts               # 服务器配置
  └── types.ts                # TypeScript类型定义

许可证

ISC

重新生成fly部署密钥

该令牌是通过以下命令创建的:

fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h </中文翻译>