MCP协议服务器

一个支持OAuth 2.1认证的轻量级MCP协议服务器,专为Claude Web集成设计,提供可流式传输的HTTP服务和健康检查功能。

  • by dgmulei
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dgmulei/minimal-mcp-server

使用说明

最小MCP服务器

一个具有OAuth 2.1身份验证的最小模型上下文协议(MCP)服务器,专为Claude Web集成而设计。

特性

  • OAuth 2.1 支持 PKCE
  • 可流式HTTP传输
  • 用于连接测试的简单ping工具
  • 符合人体MCP规范

快速开始

# Clone and install
git clone https://github.com/dgmulei/minimal-mcp-server.git
cd minimal-mcp-server
npm install

# Run locally
npm run dev

# Build for production
npm run build
npm start

端点

OAuth发现

  • /.well-known/oauth-protected-resource -资源元数据
  • /.well-known/oauth-authorization-server -认证服务器元数据

OAuth流

  • /authorize -授权端点
  • /token -令牌交换端点

主控程序

  • /mcp -主MCP端点(需要Bearer令牌)

健康

  • /health -服务器健康检查

MCP检验员测试

# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Test the server (after OAuth setup)
npx @modelcontextprotocol/inspector http://localhost:3000/mcp

Claude Web集成

  1. 在本地启动服务器: npm run dev
  2. 在Claude Web中,转到“设置”>“集成”
  3. 添加自定义集成: http://localhost:3000/mcp
  4. 完整的OAuth流程
  5. 测试方式:“使用ping工具测试连接”

建筑

  • src/index.ts -Express服务器设置
  • src/oauth.ts -OAuth 2.1端点
  • src/mcp.ts -MCP传输层
  • src/storage.ts -内存令牌存储

部署

已准备好使用KV存储部署Cloudflare Workers。