MCP TypeScript Server Starter
2025.04.16
1
HTMLMCP服务器TypeScript开发开发效率
sbb-mcp-server 是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器启动项目，提供了简单的 echo 服务器实现，展示了 MCP 的核心特性。该项目支持工具、资源和提示的创建，适用于本地开发和远程部署场景。
View on GitHub
Overview
基本能力
产品定位
sbb-mcp-server 是一个用于构建 MCP 服务器的 TypeScript 启动项目，旨在简化 MCP 服务器的开发流程。
核心功能
- 简单的 echo 服务器实现
- 支持工具、资源和提示的创建
- TypeScript 支持
- 开发服务器支持热重载
- 内置检查器用于测试和调试
- 支持 STDIO 和 SSE 两种通信模式
适用场景
- 本地 MCP 服务器开发
- 远程 MCP 服务器部署
- 与 Cursor/Claude Desktop 等工具集成
- 构建自定义 AI 交互工具
工具列表
- Echo Tool：简单的回显工具，返回输入消息
- Echo Resource：可通过 URI 访问的资源
- Echo Prompt：用于处理消息的提示模板
常见问题解答
- SSE 模式部署问题：在 Coolify 部署时需要禁用 GZIP 压缩
- 端口配置：部署时需要确保端口 3001 正确暴露
- 环境变量：建议使用 .env 文件管理敏感信息
使用教程
使用依赖
- Node.js (v16 或更高版本)
- pnpm (推荐) 或 npm
安装教程
- 克隆仓库：
git clone https://github.com/ralf-boltshauser/mcp-typescript-server-starter.git
cd mcp-typescript-server-starter
- 安装依赖：
pnpm install
调试方式
- 启动开发服务器：
pnpm dev
- 访问检查器：http://localhost:6274
- 测试 MCP 服务器：
- 在检查器中点击"Connect"
- 导航到"Tools"部分
- 点击"List Tools"
- 选择"echo"工具
- 写入测试消息
- 点击"Submit"
部署教程
- 在 Coolify 上设置：
- 连接仓库
- 在高级设置中禁用 GZIP 压缩
- 配置域名为
https://subdomain.yourdomain.com:3001 - 验证部署：
- 访问
subdomain.yourdomain.com查看 index.html - 在
https://subdomain.yourdomain.com/sse测试 SSE 连接
连接部署服务器
npx -y mcp-remote https://subdomain.yourdomain.com/sse
通信模式
STDIO 模式
- 配置服务器：
- 在
src/index.ts中注释掉 Express/SSE 代码 - 取消注释 STDIO 代码
- 构建并运行：
pnpm build
node dist/index.cjs
或
pnpm dev
SSE 模式
- 配置服务器：
- 保持 Express/SSE 代码启用
- 注释掉 STDIO 代码
- 本地开发：
pnpm dev
服务器将在以下地址可用： - 主端点: http://127.0.0.1:3001 - SSE 端点: http://127.0.0.1:3001/sse - 测试端点: http://127.0.0.1:3001/test - 检查器: http://127.0.0.1:6274