Zaptomcp

ZapToMCP是一個用於構建Model Context Protocol（MCP）服務器和客戶端的工具庫集合，提供TypeScript實現的SDK和服務器抽象，支持多種傳輸協議，簡化AI助手與工具間的通信開發。

開發者工具人工智能聊天機器人 #AI通信協議 #TypeScript工具 #模型上下文 #開發SDK .TypeScript

評分 : 2分

下載量 : 5

更新時間 : 2025-04-29

什麼是ZapToMCP?

ZapToMCP是一個開源工具集，專門用於快速構建符合Model Context Protocol標準的服務。它提供了服務器和客戶端的完整實現，讓開發者可以專注於業務邏輯而非協議細節。

如何使用ZapToMCP?

通過簡單的API調用即可創建MCP兼容服務，支持多種通信方式(HTTP/SSE/內存等)。包含完整的類型定義和開發工具鏈。

適用場景

適用於需要AI助手與工具間標準化通信的場景，如智能客服系統、自動化工作流、AI插件平臺等。

主要功能

多傳輸協議支持內置內存/SSE/Stdio/HTTP等多種通信方式，適應不同部署環境

類型安全基於TypeScript開發，提供完整的類型定義和代碼提示

高性能底層採用Fastify框架，支持高併發請求處理

模塊化設計可按需引入功能模塊，保持核心精簡

優勢與侷限性

優勢

開箱即用的MCP協議實現

豐富的開發工具和文檔支持

活躍的社區和持續更新

同時支持ESM和CommonJS模塊

侷限性

目前仍處於開發階段(Alpha)

僅支持Node.js環境

文檔尚不完善

如何使用

安裝依賴

確保系統已安裝Node.js 20+和pnpm

創建服務器

初始化MCP服務器實例並定義能力

連接傳輸層

選擇適合的通信方式(如HTTP)

使用案例

創建AI插件服務為AI助手提供天氣查詢能力

構建自動化工作流連接多個AI工具形成處理流水線

常見問題

MCP協議是什麼？

需要學習多少前置知識？

🚀 ZapToMCP

ZapToMCP 是一個基於 Model Context Protocol (MCP) 的實現，支持多種傳輸方式。它是 FastMCP 和 LiteMCP 的改進版本，適用於對高性能和高擴展性有要求的場景。

🚀 快速開始

安裝

要開始使用，請先安裝 npm 包：

npm install @zaptomcp/sdk

示例

服務器端

const { Server } = require('@zaptomcp/sdk');

async function main() {
    const server = new Server({
        name: 'test-server',
        version: '1.0.0'
    });

    await server.start();
}

main().catch(console.error);

客戶端

const { Client } = require('@zaptomcp/sdk');

async function main() {
    const client = new Client({
        name: 'test-client',
        version: '1.0.0'
    });

    await client.connect(new HTTPClientTransport('http://localhost:3000'));
}

main().catch(console.error);

✨ 主要特性

多種傳輸協議：支持內存、SSE、標準 I/O 和流式 HTTP 等多種傳輸協議。
高性能處理：優化了資源管理和數據交換效率。
易於擴展：模塊化設計，便於添加新功能和傳輸方式。

📦 安裝指南

要開始使用，請先安裝 npm 包：

npm install @zaptomcp/sdk

💻 使用示例

基礎用法

服務器端

const { Server } = require('@zaptomcp/sdk');

async function main() {
    const server = new Server({
        name: 'test-server',
        version: '1.0.0'
    });

    await server.start();
}

main().catch(console.error);

客戶端

const { Client } = require('@zaptomcp/sdk');

async function main() {
    const client = new Client({
        name: 'test-client',
        version: '1.0.0'
    });

    await client.connect(new HTTPClientTransport('http://localhost:3000'));
}

main().catch(console.error);

📚 詳細文檔

倉庫結構

項目包含以下幾個主要部分：

packages/sdk：核心的 MCP SDK，提供服務器和客戶端實現。
examples：展示如何使用 SDK 的示例代碼。
docs：項目的文檔資料。
scripts：用於項目構建、測試和其他開發任務的腳本。

開發腳本

項目提供了以下 npm 腳本：

dev：在開發模式下運行 SDK。
build：構建 SDK 包。
test：運行測試用例。

例如，在 SDK 目錄下執行：

cd packages/sdk && npm run dev

SDK 包詳細信息

功能概述

SDK 提供以下主要功能：

Server 類：用於創建和管理 MCP 服務器。
多種傳輸實現：
- InMemoryTransport：內存中的傳輸方式，適合測試環境。
- SSETransport：基於 Server-Sent Events 的即時通信。
- StdIOTransport：使用標準輸入輸出的控制檯模式。
- StreamableHTTPTransport：支持流式數據傳輸的 HTTP 協議實現。