Excel Master

TypeScript實現的MCP協議SDK，用於構建與LLM交互的標準化服務

開發者工具人工智能聊天機器人 #LLM交互 #協議SDK #上下文管理 #工具集成 .JavaScript

評分 : 2.5分

下載量 : 9.1K

更新時間 : 2025-04-28

打開站點

什麼是 MCP 服務器？

MCP 服務器是一種標準化的應用程序接口，用於為語言模型提供上下文數據和功能支持。它通過資源、工具和提示模板實現人機交互，使開發者能夠輕鬆構建高效且安全的 AI 應用。

如何使用 MCP 服務器？

MCP 服務器可以通過簡單的安裝和配置快速啟動。您可以創建自定義工具、資源和提示模板，從而滿足具體需求。服務器支持多種傳輸協議，如標準輸入輸出和 HTTP SSE。

適用場景

MCP 服務器廣泛適用於需要動態數據加載、外部功能調用以及交互式對話的場景，例如智能客服、知識管理系統和自動化開發工具。

主要功能

資源管理

允許您定義靜態或動態資源，用於向語言模型提供上下文數據。

工具集成

支持創建和部署執行復雜任務的工具，例如計算、數據庫查詢等。

提示模板

預定義提示模板，幫助語言模型更好地理解用戶意圖。

多傳輸協議

支持多種通信方式（如 stdio 和 HTTP SSE），方便與不同客戶端對接。

優勢

統一接口標準，簡化開發流程。

支持多場景應用，靈活性強。

強大的擴展能力，可根據需求定製功能。

侷限性

對於高級功能可能需要一定的編程基礎。

某些工具的性能依賴於後端實現效率。

如何使用

安裝 MCP SDK

運行以下命令安裝 MCP TypeScript SDK：`npm install @modelcontextprotocol/sdk`。

初始化 MCP 服務器

創建一個新的 MCP 服務器實例並配置基本信息，例如名稱和版本。

添加資源、工具和提示模板

根據需求定義資源、工具和提示模板，確保它們能夠滿足應用場景。

連接到傳輸層

選擇合適的傳輸協議（如 stdio 或 HTTP SSE）來連接客戶端。

使用案例

計算器工具

實現一個簡單的加法工具，用於演示工具功能。

SQLite 數據庫查詢

利用 SQLite 數據庫查詢工具獲取用戶信息。

常見問題

MCP 服務器是否支持多語言環境？

如何調試 MCP 服務器？

🚀 MCP TypeScript 軟件開發工具包（SDK）文檔

MCP TypeScript SDK 是用於構建與 MCP 協議交互的服務器和客戶端的工具包。它提供了便捷的安裝方式和豐富的使用示例，幫助開發者快速上手。

🚀 快速開始

你可以通過 npm 輕鬆安裝 MCP TypeScript SDK，然後使用示例代碼創建 MCP 服務器和客戶端。

📦 安裝指南

通過 npm 安裝

你可以使用以下命令通過 npm 安裝 MCP TypeScript SDK：

npm install @modelcontextprotocol/typescript-sdk

💻 使用示例

基礎用法

創建 MCP 服務器

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);

創建 MCP 客戶端

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["server.js"]
});

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

await client.connect(transport);

// 列舉提示
const prompts = await client.listPrompts();

// 獲取一個提示
const prompt = await client.getPrompt("example-prompt", {
  arg1: "value"
});

// 列舉資源
const resources = await client.listResources();

// 讀取資源
const resource = await client.readResource("file:///example.txt");

// 調用工具
const result = await client.callTool("example-tool", {
  arg1: "value"
});

高級用法

低級服務器類

如果你需要更多控制，可以直接使用低級 Server 類：

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);