MCP 服务器

SSE MCP Server with JWT Authentication

一个模型上下文协议服务器，通过 SSE 传输暴露多个 AI 工具，并采用基于 JWT 的安全认证，支持动态工具注册和会话管理。

README

🔐 基于 JWT 认证的 SSE MCP 服务器

这是一个基于 JWT 认证的 模型上下文协议 (MCP) SSE 服务器。它允许你通过安全的 Bearer Token 流暴露多个 AI 工具，并通过 SSE 传输进行保护。

构建于：

🚀 Node.js + Express
🧩 @modelcontextprotocol/sdk
🔒 JSON Web Tokens (JWT) 用于身份验证
⚙️ Zod 用于输入验证

✅ 经过 @modelcontextprotocol/inspector 的全面测试

📂 项目结构

server/
├── index.ts          # 主要的 Express + MCP 服务器
├── .env              # 环境变量
├── package.json      # 项目元数据和脚本
├── tsconfig.json     # TypeScript 配置
└── README.md         # 你在这里！

✨ 功能

✅ 使用 Bearer JWT 令牌的安全 SSE 连接
✅ 动态工具注册（echo、time、随机数等）
✅ 经过 MCP Inspector 测试
✅ 记录所有请求生命周期事件
✅ /message 端点的会话管理
🚀 准备好扩展以供生产使用

⚙️ 设置

1. 克隆存储库

git clone https://github.com/anisirji/mcp-server-remote-setup-with-jwt-auth.git
cd mcp-server-remote-setup-with-jwt-auth

2. 安装依赖

npm install

3. 创建 `.env` 文件

echo "JWT_SECRET=your-secret-key" > .env

4. 运行服务器

npm run dev

✅ 服务器将在以下地址运行：

http://localhost:3001/sse

🧪 使用 MCP Inspector 测试服务器

步骤 1 — 安装 MCP Inspector

📖 官方文档: MCP Inspector

npx @modelcontextprotocol/inspector

步骤 2 — 生成令牌

使用 cURL 获取你的 JWT 令牌：

curl "http://localhost:3001/auth/token?username=aniket&scope=mcp:access"

✅ 示例响应：

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

步骤 3 — 连接 MCP Inspector

打开 Inspector UI
设置传输类型：SSE
URL:
```
http://localhost:3001/sse
```
添加授权标头：
```
Authorization: Bearer <your-token>
```
点击 Connect

🎉 成功！你的服务器现在已连接。

步骤 4 — 测试工具

转到 Inspector 中的 Tools 选项卡，然后单击 List Tools。

你将看到：

✅ test
✅ echo
✅ get-time
✅ random-number

测试它们并享受！

📖 API 参考

🔑 生成令牌

GET /auth/token?username=<username>&scope=mcp:access

🔌 SSE 端点 (需要令牌)

GET /sse
Authorization: Bearer <token>

📩 向活动会话发送消息

POST /message?sessionId=<sessionId>
Authorization: Bearer <token>

🧩 工具参考

工具名称	描述
`test`	测试连接（安全检查）
`echo`	回显提供的消息
`get-time`	返回当前服务器时间
`random-number`	返回随机数（最小值/最大值）