Search1api

🚀 MCP TypeScript SDK

TypeScript 實現的模型上下文協議（MCP），為大語言模型（LLM）集成提供客戶端和服務端功能

🚀 快速開始

創建客戶端

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

const transport = new StdioClientTransport({
  command: "path/to/server",
});

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

await client.connect(transport);

// 列出可用資源
const resources = await client.request(
  { method: "resources/list" },
  ListResourcesResultSchema
);

// 讀取特定資源
const resourceContent = await client.request(
  {
    method: "resources/read",
    params: {
      uri: "file:///example.txt"
    }
  },
  ReadResourceResultSchema
);

創建服務器

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

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

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
    ],
  };
});

server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  if (request.params.uri === "file:///example.txt") {
    return {
      contents: [
        {
          uri: "file:///example.txt",
          mimeType: "text/plain",

✨ 主要特性

• 模型上下文協議允許應用程序以標準化方式為大語言模型提供上下文信息，將上下文提供與實際的語言模型交互分離開來。
• 此 TypeScript SDK 實現了完整的 MCP 規範，使其易於：
  • 構建可以連接到任何 MCP 服務器的客戶端
  • 創建暴露資源、提示和工具的 MCP 服務器
  • 使用標準傳輸協議如 stdio 和 SSE
  • 處理所有 MCP 協議消息和生命週期事件

📦 安裝指南

npm install @modelcontextprotocol/sdk

💻 使用示例

基礎用法

// 創建客戶端示例代碼
import { Client } from "@modelcontextprotocol/sdk/client";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio";

const transport = new StdioClientTransport({
  command: "path/to/server",
});

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

await client.connect(transport);

// 列出可用資源
const resources = await client.request(
  { method: "resources/list" },
  ListResourcesResultSchema
);

// 讀取特定資源
const resourceContent = await client.request(
  {
    method: "resources/read",
    params: {
      uri: "file:///example.txt"
    }
  },
  ReadResourceResultSchema
);

高級用法

// 創建服務器示例代碼
import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

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

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
    ],
  };
});

server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  if (request.params.uri === "file:///example.txt") {
    return {
      contents: [
        {
          uri: "file:///example.txt",
          mimeType: "text/plain",