mcpField
H
HTTP Server with MCP Support

HTTP Server with MCP Support

本地服务
github.com/jhgaylor开发工具378 周前更新

关于 HTTP Server with MCP Support

这是一个基于 Express 和 TypeScript 的 HTTP 服务示例,可提供网页和候选人信息,适合开发者定制候选人数据服务,并支持无状态 MCP Streamable HTTP。

主要功能

  1. 01提供网页和 MCP 端点
  2. 02无状态 Streamable HTTP 传输
  3. 03通过环境变量配置候选人信息
  4. 04基于 Express 和 TypeScript 实现

适用场景

  1. 01向 MCP 客户端提供候选人信息
  2. 02自定义联系、简历和个人资料链接
  3. 03开发 HTTP 与 MCP 服务示例

MCP 相关

除网页外,还通过 Streamable HTTP 提供无状态 MCP 端点。候选人信息可通过环境变量或 `src/config.ts` 配置。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

支持 MCP 的 HTTP 服务

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

功能

  • 同时具备 Web 和 MCP 功能的 HTTP 服务
  • 使用现代 Streamable HTTP 传输的无状态 MCP 服务实现
  • 使用 TypeScript 确保类型安全
  • 使用 Express.js 处理 HTTP 请求

要求

  • Node.js 18+
  • npm 或 yarn

安装

# Clone the repository (or download)
git clone https://github.com/your-username/example-candidate-mcp-server.git
cd example-candidate-mcp-server

# Install dependencies
npm install

# Start the http transport
npm run start:web

# Start the stdio transport
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 中更新这些变量。

开发

# Build the TypeScript code
npm run build

# Run in development mode with auto-reloading
npm run dev

# Run tests (when added)
npm test

服务结构

src/
  ├── index.ts                # Main application entry point
  ├── express.ts              # HTTP server configuration
  ├── stdio.ts                # STDIO server configuration
  ├── config.ts               # Server configuration
  └── types.ts                # TypeScript type definitions

许可证

ISC

重新生成 fly 部署密钥

令牌通过以下命令创建:

fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。