TypeScript MCP服务器

一个使用TypeScript MCP SDK、Express和自定义Docker容器构建的简单MCP服务器,支持HTTP和STDIO传输,适用于在Smithery平台上托管HTTP服务器。

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

使用说明

带有自定义容器的TypeScript MCP服务器

使用官方工具构建的简单TypeScript MCP服务器 MCP TypeScript SDK(MCP TypeScript软件开发工具包)使用Express和自定义Docker容器。此示例展示了如何在Smithery上使用自定义容器托管HTTP服务器,并支持STDIO以保持向后兼容性。

查看完整指南:https://smithery.ai/docs/migrations/typescript-custom-container

在Smithery上现场试用一下

特点:

  • **CORS(跨源资源共享)**基于浏览器的MCP客户端的CORS头部信息
  • Smithery 会话配置处理通过Smithery传递的用户会话配置了解更多)
  • 请求记录中间件用于调试HTTP请求和响应的自定义中间件
  • 服务器传输可以同时使用STDIO和HTTP传输方式运行 TRANSPORT 环境变量

先决条件

  • Node.js 22 或更高版本
  • npm 包管理器

项目结构

  • src/index.ts - 主Express服务器,配备MCP HTTP传输
  • package.json - Node.js 依赖项和脚本
  • smithery.yaml - Smithery 部署和会话配置
  • Dockerfile - Dockerfile 用于在 Smithery 中托管服务器

快速入门

  1. 安装依赖项:

    npm install
    
  2. 运行开发服务器:

    HTTP 模式:

    npm run dev
    

    这将在8081端口启动服务器。

  3. 交互式测试: 一旦您的服务器以HTTP模式运行,您就可以使用Smithery游乐场进行交互式测试:

    npx -y @smithery/cli playground --port 8081
    
  4. 部署您自己的版本: 部署您自己的MCP服务器: