
MCP TypeScript Server Starter

2025.04.16
0
HTMLMCP 服务器开发TypeScript 框架开发效率
MCP TypeScript Server Starter 是一个用于构建 Model Context Protocol (MCP) 服务器的 TypeScript 启动项目。它提供了一个简单的回声服务器实现,展示了 MCP 的核心功能。该项目支持工具、资源和提示的创建,适用于本地开发和远程部署。
View on GitHub
Overview
基本能力
产品定位
MCP TypeScript Server Starter 是一个用于快速构建 MCP 服务器的开发框架,特别适合需要与 AI 交互的应用开发。
核心功能
- 简单的回声服务器实现
- 支持工具、资源和提示的创建
- TypeScript 支持
- 开发服务器支持热重载
- 内置测试和调试检查器
- 支持 STDIO 和 SSE 两种通信模式
适用场景
- 本地开发 MCP 服务器
- 远程部署 MCP 服务器
- 与 AI 工具(如 Cursor 或 Claude Desktop)集成
- 快速原型开发
工具列表
- Echo Tool:一个简单的工具,回显输入消息
- Echo Resource:一个可以通过 URI 访问的资源
- Echo Prompt:一个用于处理消息的提示模板
常见问题解答
- 如何选择通信模式?
- 本地开发使用 STDIO 模式
- 远程部署使用 SSE 模式
- 如何调试服务器?
- 使用内置检查器访问 http://localhost:6274
- 部署时需要注意什么?
- 禁用 GZIP 压缩(SSE 流需要)
- 确保端口 3001 正确暴露
使用教程
使用依赖
- Node.js (v16 或更高版本)
- pnpm (推荐) 或 npm
安装教程
- 克隆仓库:
bash git clone https://github.com/ralf-boltshauser/mcp-typescript-server-starter.git cd mcp-typescript-server-starter
- 安装依赖:
bash pnpm install
调试方式
- 启动开发服务器:
bash pnpm dev
- 访问检查器:http://localhost:6274
- 测试 MCP 服务器:
- 点击检查器中的 "Connect"
- 导航到 "Tools" 部分
- 点击 "List Tools"
- 选择 "echo" 工具
- 写入测试消息
- 点击 "Submit"