内容
# HTTP 服务器与 MCP 支持
一个使用 Express 和 TypeScript 构建的 HTTP 服务器,提供网页和模型上下文协议(MCP)端点服务。
## 功能特点
- 具备网页和 MCP 功能的 HTTP 服务器
- 无状态 MCP 服务器实现,采用现代可流式传输的 HTTP 传输协议
- 使用 TypeScript 以确保类型安全
- 使用 Express.js 进行 HTTP 请求处理
## 要求
- Node.js 18+
- npm 或 yarn
## 安装
```bash
# 克隆仓库(或下载)
git clone https://github.com/your-username/example-candidate-mcp-server.git
cd example-candidate-mcp-server
# 安装依赖
npm install
# 启动 HTTP 传输
npm run start:web
# 启动标准输入/输出传输
npm run start
```
## 自定义候选人数据
要自定义候选人数据,您可以在环境中或在项目根目录下的 `.env` 文件中设置以下环境变量:
- `CONTACT_EMAIL`:服务器的联系邮箱地址。
- `MAILGUN_API_KEY`:用于发送电子邮件的 Mailgun API 密钥。
- `MAILGUN_DOMAIN`:用于发送电子邮件的 Mailgun 域名。
- `CANDIDATE_NAME`:候选人的姓名。
- `RESUME_URL`:候选人简历的 PDF 格式网址。
- `LINKEDIN_URL`:候选人 LinkedIn 资料的网址。
- `GITHUB_URL`:候选人 GitHub 资料的网址。
- `WEBSITE_URL`:候选人个人网站的网址。
这些变量用于配置服务器并自定义 MCP 服务器提供的候选人信息。请确保在修改这些变量后重启服务器,以便更改生效。
您也可以直接在 `src/config.ts` 中更新它们。
## 开发
```bash
# 编译 TypeScript 代码
npm run build
# 在开发模式下运行并自动重新加载
npm run dev
# 运行测试(当添加时)
npm test
```
## 服务器结构
```
src/
├── index.ts # 主应用程序入口点
├── express.ts # HTTP 服务器配置
├── stdio.ts # 标准输入/输出服务器配置
├── config.ts # 服务器配置
└── types.ts # TypeScript 类型定义
```
## 许可证
[ISC](LICENSE)
## 重新生成 Fly 部署密钥
令牌是使用以下命令创建的:
`fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h`