mcp-runner
2025.01.28
5
TypeScriptMCP 服务器管理TypeScript SDKCLI 工具开发效率
mcp-runner 是一个 TypeScript SDK 和 CLI 工具，用于运行基于 MCP（Model Context Protocol）的服务器。它支持服务器进程的复用、优雅终止和自动生命周期管理，适用于需要高效运行和管理 MCP 服务器的场景。
View on GitHub
Overview
基本能力
产品定位
mcp-runner 是一个用于运行和管理 MCP 服务器的工具，旨在简化 MCP 服务器的执行和生命周期管理。
核心功能
- 服务器进程复用：支持跨多个调用复用服务器进程。
- 优雅终止：支持超时处理和优雅终止。
- 自动生命周期管理：自动管理服务器的启动和终止。
- TypeScript 支持：提供 TypeScript SDK 和 CLI 工具。
- 错误处理和日志记录：全面的错误处理和日志记录功能。
适用场景
- 需要高效运行和管理 MCP 服务器的开发环境。
- 需要在多个操作中复用同一服务器进程的场景。
- 需要自动化服务器生命周期管理的场景。
工具列表
- list-tools：列出指定 MCP 服务器的所有可用工具。
- runserver：运行指定的 MCP 服务器，支持可选工具名称和参数。
使用教程
使用依赖
安装 Node.js 和 npm。
安装教程
npm install
调试方式
运行测试：
npm test
构建项目：
npm run build
API
runServer(serverName: string, params: Record)
运行指定服务器上的工具，使用提供的参数。服务器进程在后续调用中会被复用，直到显式终止。
terminateServer()
终止由 SDK 管理的服务器进程。应在所有操作完成后调用。