模型上下文协议服务器

一个基于StreamableHTTPServerTransport的远程MCP服务器实现示例,提供计算、用户列表和用户统计功能。

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

使用说明

MCP服务器示例

本项目是使用StreamableHTTPServerTransport实现远程模型上下文协议(MCP)服务器的示例。

💡 提示:如果您是第一次使用MCP服务器, MCP官方文档请参阅。

开始

依赖性安装

npm install

执行方法

本地开发环境

npm run dev

生产环境

npm run build
npm start

交付工具

计算器

  • 功能:执行简单的公式计算

用户列表

  • 功能:查看特定时间段内的用户列表

用户统计

  • 功能:查看特定期间的用户统计信息

首选参数

环境变量

变量名说明是否必需 |--------|------|-----------| | TOKEN | API身份验证令牌 Authorization 헤더와 일치하는 경우 인증 |必需| | ALLOWED_ORIGIN | CORS Origin |选择|

设置环境变量示例

# .env 파일
TOKEN=your-secret-token-here
ALLOWED_ORIGIN=

客户端设置

Cursor IDE设置

.cursor-settings.json 在文件中设置:

{
  "mcpServers": {
    "example": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

📝 请参见: <TOKEN>实际环境变量 TOKEN 请用值替换。

API端点

  • 基本URL: http://localhost:3000
  • MCP端点: /mcp

认证

服务器使用Bearer Token身份验证:

Authorization: Bearer <TOKEN>

更多信息

设置开发环境

# 의존성 설치
npm install

# 개발 서버 시작
npm run dev

生产部署

# 빌드
npm run build

# 프로덕션 서버 시작
npm start

故障排除

常见问题

  • 401未经授权:验证是否设置了TOKEN环境变量
  • 连接被拒绝:验证服务器是否已正确启动

📄 许可证

MIT许可证