MCP Server com SSE e Autenticação Bearer

基本能力

产品定位

MCP Server com SSE e Autenticação Bearer 是一个用于实现实时通信和安全认证的 MCP 协议服务器，主要用于开发工具和 LLM 主机的集成。

核心功能

1. SSE 实时通信：使用 Server-Sent Events 实现客户端与服务器的实时通信。
2. Bearer Token 认证：通过 Authorization 头部进行安全认证。
3. 示例工具：提供四个基础数学运算工具，展示 MCP 工具的注册和执行流程。
4. 模块化架构：基于 SOLID 和 Clean Code 原则设计，代码结构清晰。
5. 开发友好：支持 ts-node 直接运行，无需预编译，便于开发和调试。

适用场景

1. LLM 主机集成：如 Claude Desktop 等工具与 MCP 服务器的实时通信。
2. 开发工具链：用于构建需要实时通信和安全认证的开发工具。
3. 教学示例：展示 MCP 协议和 SSE 的实现方式。

工具列表

1. 基础数学工具：
2. 加法
3. 减法
4. 乘法
5. 除法

常见问题解答

1. 如何设置 Bearer Token？
2. 在 .env 文件中设置 BEARER_TOKEN=meu-token-secreto。
3. 如何调试？
4. 使用 npm run dev 直接运行开发版本。
5. 如何查看工具列表？
6. 访问 http://127.0.0.1:6274 使用 @modelcontextprotocol/inspector 查看。

使用教程

使用依赖

1. 安装 Node.js 20+ bash sudo apt update sudo apt install -y nodejs
2. 安装 npm bash sudo apt install -y npm
3. 安装 TypeScript 和 ts-node bash npm install -g typescript ts-node

安装教程

1. 克隆仓库 bash git clone <URL_DO_REPOSITORIO> cd mcp-sse
2. 安装依赖 bash npm install
3. 配置环境变量
4. 创建 .env 文件并添加： txt BEARER_TOKEN=meu-token-secreto PORT=3001

调试方式

1. 开发模式运行 bash npm run dev
2. 使用 Inspector 工具 bash npm run dev:inspect
3. 访问 http://127.0.0.1:6274 查看工具列表。
4. 生产环境运行 bash npm run build node dist/index.js

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。