MCP Server Client

🚀 MCP 服務器 - 客戶端示例

本項目藉助 TypeScript SDK 實現了基礎的 Model Context Protocol (MCP) 功能。它涵蓋了一個用於提供資源訪問的 MCP 服務器，以及一個連接該服務器並請求資源的客戶端，為 MCP 的應用提供了直觀的示例。

🚀 快速開始

此示例包含一個 MCP 服務器和一個 MCP 客戶端。服務器用於提供資源訪問，客戶端則連接到服務器並請求資源，同時具備基本的資源列表和讀取功能。

📦 安裝指南

先決條件

• Node.js (v16 或更高版本)
• npm

安裝步驟

克隆倉庫並安裝依賴項：

npm install

💻 使用示例

基礎用法

您需要在兩個單獨的終端窗口中運行服務器和客戶端。

1. 啟動服務器：

npm run start:server

2. 在新終端中，啟動客戶端：

npm run start:client

客戶端將執行以下操作：

1. 連接到服務器
2. 請求可用資源列表
3. 讀取示例資源的內容

📚 詳細文檔

項目結構

src/
  ├── index.ts    # 服務器實現
  └── client.ts   # 客戶端實現

服務器功能

當前服務器支持的功能包括：

• 資源列表
• 資源讀取
• 未知資源的基本錯誤處理

可用資源

示例服務器提供以下資源：

• file:///example.txt：一個簡單的文本資源

開發

腳本

• npm run start:server：啟動 MCP 服務器
• npm run start:client：啟動 MCP 客戶端

添加新資源

要在服務器中添加新的資源，請修改 ListResourcesRequestSchema 處理器在 src/index.ts 中：

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
      // 在此處添加新的資源
    ],
  };
});

依賴項

📄 許可證

本項目採用 ISC 許可證。