TypeScript MCP服务器模板

一个轻量级的TypeScript MCP服务器模板,使用stdio传输,Zod进行输入验证,Biome进行代码格式化和linting。适用于需要快速搭建MCP服务器的开发场景。

  • by JMoak
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 JMoak/ts-mcp-template

使用说明

ts mcp模板

轻量级TypeScript MCP服务器模板使用stdio传输,Zod用于输入验证,Biome用于linting/格式化。

特征:

  • 最小MCP服务器 echo 工具
  • Zod运行时验证+JSON模式暴露 zod-to-json-schema
  • ESM、TypeScript和 npm-友好的包装 npx 用法
  • lint/format的生物特征配置

安装/构建

  • 安装deps: npm install
  • 构建: npm run build (输出到 dist/)

地方发展与督察

要在本地测试和调试MCP服务器,请使用MCP检查器:

  • 启动检查器: npm run inspector

检查员提供了一个web界面 http://localhost:6274 以交互方式测试您的MCP服务器工具。配置存储在 .local-mcp/mcp.json.

用法

直接通过Node运行:

node dist/index.js

或者,一旦发布,使用npx运行:

npx ts-mcp-template

服务器按照MCP惯例通过stdio进行通信。它公开了一个工具:

  • 姓名: echo
  • description:回显输入文本
  • 输入架构:
    • text (字符串,必填):要回显的文本
    • uppercase (boolean,可选):返回大写文本

开发说明

  • 节点>=22.0.0
  • TypeScript配置保留了shebang供CLI使用。
  • 对于lint/格式:
    • 棉绒: npm run lint
    • 格式: npm run format

许可证

麻省理工学院