Joeblockchain MCP Server Client

🚀 MCP 服務器 - 客戶端示例

本項目藉助 TypeScript SDK，為你展示了 Model Context Protocol (MCP) 的基礎實現。它涵蓋了一個用於提供資源訪問的服務器，以及一個連接至該服務器併發起資源請求的客戶端，二者通過 stdio 傳輸進行通信。

🚀 快速開始

本示例包含提供資源訪問的 MCP 服務器、連接服務器並請求資源的 MCP 客戶端，具備基本的資源列表和讀取功能。

先決條件

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

安裝

克隆倉庫並安裝依賴項：

npm install

運行示例

你需要分別在兩個終端窗口中運行服務器和客戶端。

1. 啟動服務器：

npm run start:server

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

npm run start:client

客戶端將執行以下操作：

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

✨ 主要特性

服務器功能

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

• 資源列表
• 資源讀取
• 基本錯誤處理（針對未知資源）

可用資源

示例服務器提供以下資源訪問權限：

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

📦 安裝指南

克隆倉庫並安裝依賴項：

npm install

💻 使用示例

基礎用法

你需要分別在兩個終端窗口中運行服務器和客戶端。 啟動服務器：

npm run start:server

在新終端中啟動客戶端：

npm run start:client

高級用法

添加新資源

要添加新資源，請修改 ListResourcesRequestSchema 處理器位於 src/index.ts：

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

📚 詳細文檔

項目結構

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

開發

腳本

• 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