Excel Master

🚀 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);

貢獻指南

我們歡迎社區的貢獻！如果發現任何問題或有任何建議，請訪問我們的 GitHub 倉庫： GitHub 倉庫

📚 詳細文檔

• MCP 協議文檔
• MCP 規範
• 示例服務器