@opentiny/next 0.3.0 → 0.3.2

package/README.md

@@ -12,7 +12,7 @@ OpenTiny NEXT 是一个基于 Model Context Protocol（MCP）的 TypeScript 库
 npm install @opentiny/next
 ```
 
-## 客户端 API
+## 客户端 API (client.js)
 
 客户端 API 主要用于在浏览器环境中的 MCP 通信。
 
@@ -31,9 +31,16 @@ import { createTransportPair } from '@opentiny/next';
 const [serverTransport, clientTransport] = createTransportPair();
 
 // 创建 MCP 服务端和客户端实例
-const capabilities = { prompts: {}, resources: {}, tools: {}, logging: {} };
-const server = new McpServer({ name: 'mcp-server', version: '1.0.0' }, { capabilities });
-const client = new Client({ name: 'mcp-client', version: '1.0.0' }, { capabilities });
+const serverCapabilities = {
+  prompts: { listChanged: true },
+  resources: { subscribe: true, listChanged: true },
+  tools: { listChanged: true },
+  completions: {},
+  logging: {}
+};
+const clientCapabilities = { roots: { listChanged: true }, sampling: {}, elicitation: {} };
+const server = new McpServer({ name: 'mcp-server', version: '1.0.0' }, { capabilities: serverCapabilities });
+const client = new Client({ name: 'mcp-client', version: '1.0.0' }, { capabilities: clientCapabilities });
 
 // 建立服务端和客户端的通信连接
 await server.connect(serverTransport);
@@ -43,7 +50,7 @@ await client.connect(clientTransport);
 state.client = client;
 ```
 
-#### 在浏览器主线程与 iframe、Web Worker 等互相通信的场景
+#### 在浏览器主线程与iframe、Web Worker等互相通信的场景
 
 使用 `MessageChannelServerTransport` 和 `MessageChannelClientTransport` 创建用于监听的 Transport 服务端实例，以及用于连接的 Transport 客户端实例来进行通信。
 
@@ -57,7 +64,13 @@ import { MessageChannelServerTransport } from '@opentiny/next';
 const serverTransport = new MessageChannelServerTransport('endpoint');
 
 // 创建 MCP 服务端实例
-const capabilities = { prompts: {}, resources: {}, tools: {}, logging: {} };
+const capabilities = {
+  prompts: { listChanged: true },
+  resources: { subscribe: true, listChanged: true },
+  tools: { listChanged: true },
+  completions: {},
+  logging: {}
+};
 const server = new McpServer({ name: 'mcp-server', version: '1.0.0' }, { capabilities });
 
 // 监听 endpoint 端点，等待客户端连接
@@ -77,7 +90,7 @@ import { MessageChannelClientTransport } from '@opentiny/next';
 const clientTransport = new MessageChannelClientTransport('endpoint');
 
 // 创建 MCP 客户端实例
-const capabilities = { prompts: {}, resources: {}, tools: {}, logging: {} };
+const capabilities = { roots: { listChanged: true }, sampling: {}, elicitation: {} };
 const client = new Client({ name: 'mcp-client', version: '1.0.0' }, { capabilities });
 
 // 建立服务端和客户端的通信连接

package/index.d.ts

@@ -3,6 +3,7 @@ import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { StreamableHTTPReconnectionOptions, StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { WebSocketClientTransport } from '@modelcontextprotocol/sdk/client/websocket.js';
 import { EventSourceInit } from 'eventsource';
 import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
 import { OAuthClientMetadata, OAuthClientInformation, OAuthClientInformationFull, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
@@ -218,6 +219,16 @@ declare const createStreamProxy: (options: ProxyOptions) => Promise<{
     transport: StreamableHTTPClientTransport;
     sessionId: string;
 }>;
+/**
+ * 创建一个 WebSocket 客户端代理。
+ *
+ * @param options - 客户端代理选项
+ * @returns - 返回一个包含 transport 和 sessionId 的对象
+ */
+declare const createSocketProxy: (options: ProxyOptions) => Promise<{
+    transport: WebSocketClientTransport;
+    sessionId: string;
+}>;
 
 interface AuthClientProviderOptions {
     clientMetadata: OAuthClientMetadata;
@@ -321,5 +332,5 @@ declare class AuthClientProvider implements OAuthClientProvider {
     codeVerifier(): string;
 }
 
-export { AuthClientProvider, MessageChannelClientTransport, MessageChannelServerTransport, MessageChannelTransport, attemptConnection, createSseProxy, createStreamProxy, createTransportPair, sseOptions, streamOptions };
+export { AuthClientProvider, MessageChannelClientTransport, MessageChannelServerTransport, MessageChannelTransport, attemptConnection, createSocketProxy, createSseProxy, createStreamProxy, createTransportPair, sseOptions, streamOptions };
 export type { AuthClientProviderOptions, ProxyOptions };