Boot MCP

🚀 boot-mcp

一個全面的啟動模板，用於構建帶有 TypeScript 的 Model Context Protocol (MCP) 應用程序。

[![npm 版本][npm-version-src]][npm-version-href] [![npm 下載量][npm-downloads-src]][npm-downloads-href] [![bundle][bundle-src]][bundle-href] [![JSDocs][jsdocs-src]][jsdocs-href] [![許可證][license-src]][license-href] [![javascript 代碼風格][code-style-image]][code-style-url]

🚀 快速開始

此模板包括不同傳輸的 MCP 服務器示例：

• Stdio 傳輸（用於命令行工具和直接集成）
• 帶 SSE 的 HTTP 傳輸（用於遠程服務器）

運行示例服務器

# 啟動基本的 stdio 服務器
pnpm start:basic

# 啟動 HTTP 服務器
pnpm start:http

✨ 主要特性

資源

• 文本和二進制資源支持
• 帶有工具的動態資源
• 標準資源類型（如文本、JSON）
• 工廠函數創建自定義資源
• 上下文中的資源訪問

工具

• 帶上下文的命令執行工具
• 工具鏈實現
• 實驗室環境配置
• 動態工具加載和卸載

提示

• 用於提示的模板字符串
• 模板擴展支持
• 上下文變量注入
• 提示歷史記錄
• 回調支持

根

• 上下文根定義
• 標準上下文屬性
• 動態上下文擴展
• 父子上下文繼承
• 上下文序列管理

傳輸

• 標準傳輸實現（如 HTTP）
• 自定義傳輸開發
• 傳輸協議標準化
• 傳輸性能優化
• 傳輸日誌記錄和跟蹤

採樣

• LLM 請求完成
• 帶上下文的採樣
• 採樣結果處理
• 採樣策略實現
• 多語言支持

📦 安裝指南

# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

📚 詳細文檔

什麼是 MCP？

Model Context Protocol (MCP) 讓你可以構建服務器，以安全、標準的方式為 LLM 應用程序提供數據和功能。想象一下，它就像 Web API，但專門為 LLM 交互設計。MCP 服務器可以：

• 通過 資源（類似於 GET 端點；它們用於將信息加載到 LLM 的上下文中）暴露數據
• 通過 工具（類似於 POST 端點；它們用於執行代碼或產生副作用）提供功能
• 通過 提示（LLM 交互的重用模板）定義交互模式
• 通過 根（定義服務器的操作範圍）
• 通過 採樣（允許服務器從 LLM 請求完成）啟用代理行為
• 通過 傳輸（客戶端和服務器之間的通信機制）建立連接

項目結構

boot-mcp/
├── src/
│   ├── index.ts          # 主入口點
│   ├── server/           # MCP 服務器實現
│   │   ├── basic.ts      # 帶有通用功能的基本服務器
│   │   └── http.ts       # 帶 SSE 的 HTTP 傳輸服務器
│   ├── resources/        # 資源實現
│   │   └── index.ts      # 各種標準資源類型和工具
│   ├── tools/            # 工具實現
│   │   └── index.ts      # 按類別組織的各種工具
│   ├── prompts/          # 提示實現
│   │   └── index.ts      # 常見提示模板和工作流程
│   ├── roots/            # 根管理
│   │   └── index.ts      # 根定義和工具
│   ├── transports/       # 傳輸實現
│   │   └── index.ts      # Stdio 和 HTTP/SSE 傳輸
│   └── sampling/         # 採樣實用程序（實驗性）
│       └── index.ts      # LLM 採樣功能
├── examples/             # 示例用法
│   ├── basic-server.ts   # 基本 stdio 服務器示例
│   └── http-server.ts    # HTTP 服務器示例
└── test/                 # 測試

📄 許可證

MIT License