本地 MCP 服务器（带 HTTPS 和 GitHub OAuth）

本项目是一个使用 Node.js 和 Express 构建的安全本地 MCP 服务器。它具有使用自签名证书的 HTTPS 加密、GitHub OAuth 身份验证以及其他安全措施，如速率限制和 HTTP 标头保护。

功能

• HTTPS 加密：确保客户端和服务器之间的安全通信。
• GitHub OAuth 身份验证：允许用户使用其 GitHub 帐户登录。
• 速率限制：防止滥用和拒绝服务 (DoS) 攻击。
• 安全会话管理：使用带有安全 Cookie 的 express-session。
• HTTP 标头安全：实施 helmet 以防止常见漏洞。

前提条件

在开始之前，请确保您的系统上已安装以下内容：

• Node.js（v16 或更高版本）
• npm（随 Node.js 一起提供）
• OpenSSL（用于生成 SSL 证书）

设置说明

步骤 1：克隆存储库

将此存储库克隆到您的本地计算机：

git clone https://github.com/omar-steam/MCP-Server-with-HTTPS-and-GitHub-OAuth.git cd mcp-server

步骤 2：安装依赖项

安装所需的 npm 包：

npm install

步骤 3：生成 SSL 证书

使用 OpenSSL 生成自签名 SSL 证书：

openssl genrsa -out key.pem 2048 openssl req -new -key key.pem -out csr.pem openssl x509 -req -days 365 -in csr.pem -signkey key.pem -out cert.pem

这将在您的项目目录中创建以下文件：

• key.pem：私钥
• cert.pem：自签名证书

步骤 4：配置环境变量

在项目的根目录中创建一个 .env 文件，并添加以下变量：

CLIENT_ID=your-github-client-id CLIENT_SECRET=your-github-client-secret REDIRECT_URI=https://localhost:3000/auth/callback SESSION_SECRET=your-session-secret

将 your-github-client-id 和 your-github-client-secret 替换为您 GitHub OAuth 应用程序 中的凭据。

步骤 5：启动服务器

运行服务器： node server.js

您应该看到：

Secure server running on https://localhost:3000

用法

访问服务器

打开您的浏览器并导航到：

https://localhost:3000

通过 GitHub 身份验证

1. 访问 /auth 以启动 GitHub 身份验证过程：

https://localhost:3000/auth

2. 成功登录后，您将被重定向到 /success。
3. 如果身份验证失败，您将被重定向到 /failure。

受保护的路由

访问 /secure-data 以测试需要身份验证的路由：

https://localhost:3000/secure-data

如果您未通过身份验证，您将看到 401 Unauthorized 错误。

项目结构

mcp-server/ ├── key.pem # HTTPS 的私钥 ├── cert.pem # HTTPS 的自签名证书 ├── server.js # 主服务器文件 ├── package.json # 项目元数据和依赖项 ├── .env # 环境变量（不包含在版本控制中） └── README.md # 项目文档（此文件）

故障排除

端口已被使用 (EADDRINUSE)

如果端口 3000 已被使用，请停止任何使用它的进程或更改 server.js 中的端口。

要查找并终止使用端口 3000 的进程：

netstat -ano | findstr :3000 taskkill /PID <PID> /F

浏览器中的证书警告

自签名证书不受浏览器信任。 对于生产环境，请使用受信任的证书颁发机构，例如 Let’s Encrypt。

贡献

欢迎 fork 此存储库，进行改进并提交 pull request！ 欢迎贡献。

许可证

本项目根据 MIT 许可证获得许可。 有关详细信息，请参阅 LICENSE 文件。

致谢

特别感谢：

• Express.js
• Passport.js
• Helmet
• OpenSSL

---

祝大家构建安全的 MCP 服务器愉快！ 🔥🔥🔥

---

自定义注意事项：

1. 将 your-github-client-id 等占位符替换为您的实际凭据。
2. 如果您托管此代码，请使用您的 GitHub 存储库链接更新存储库 URL (git clone)。