open-index/open-npm huggingface dataset:
npm package: @kagol/next-sdk-copilot
Description: Simplified SDK for building intelligent web applications with MCP protocol
Author: OpenTiny Team
Latest version: 0.0.1

# @opentiny/next-sdk

一个简化的 SDK，用于快速构建基于 MCP 协议的智能 Web 应用。

## 特性

- 🚀 **简化的 API**: 将复杂的 MCP 协议封装成简单易用的接口
- 🔄 **自动重连**: 内置连接管理和自动重连机制
- 🛠️ **工具支持**: 简化的工具、资源、提示注册
- ⏱️ **长任务支持**: 内置进度报告和任务取消机制
- 🔐 **认证管理**: 自动处理认证和授权流程
- 📱 **用户引导**: 简化的用户输入收集机制

## 安装

```bash
npm install @opentiny/next-sdk
```

## 快速开始

客户端使用

```typescript
import { createClient } from '@opentiny/next-sdk';

const client = createClient({
  name: 'My App Client',
  mcpUrl: 'http://localhost:3000/mcp'
});

await client.initialize();
```

服务端使用

```typescript
import { createServer } from '@opentiny/next-sdk';

const server = createServer({
  name: 'My App Server'
});

await server.initialize(transport);

// 注册工具
server.addTool(
  'calculate',
  '执行计算',
  async ({ a, b, operation }) => {
    switch (operation) {
      case 'add': return a + b;
      case 'subtract': return a - b;
      default: throw new Error('Unsupported operation');
    }
  }
);
```

## API 文档

NextSDKClient

构造函数选项

- name: 客户端名称
- version: 客户端版本
- mcpUrl: MCP 服务器 URL
- authUrl: 认证服务器 URL
- clientMetadata: 客户端元数据配置

方法

- initialize(): 初始化客户端
- cleanup(): 清理资源
- getClient(): 获取原始 MCP 客户端实例

NextSDKServer

构造函数选项

- name: 服务器名称
- version: 服务器版本
- capabilities: 服务器能力配置

方法

- initialize(transport): 初始化服务器
- addTool(name, description, handler, parameters?): 注册工具
- addResource(name, uri, handler): 注册资源
- addPrompt(name, handler): 注册提示
- addLongTask(name, description, handler): 注册长任务
- elicitUserInput(message, schema): 收集用户输入
- sendLog(level, message): 发送日志
- requestSampling(messages, options?): 请求大模型

## 示例

查看 examples/ 目录获取更多使用示例。

## 许可证

MIT

这个 SDK 的设计目标是：

1. **简化复杂性**: 将原本需要 6 个步骤的复杂配置简化为几行代码
2. **提供默认值**: 为大部分配置项提供合理的默认值
3. **保持灵活性**: 允许高级用户自定义配置
4. **错误处理**: 内置错误处理和重连机制
5. **类型安全**: 提供完整的 TypeScript 类型支持

主要简化的方面：

- **客户端初始化**: 从复杂的多步骤配置简化为单个 `initialize()` 调用
- **工具注册**: 从复杂的 zod 类型定义简化为简单的参数对象
- **长任务处理**: 内置进度报告和取消机制
- **资源管理**: 简化资源注册和更新流程
- **错误处理**: 自动处理连接错误和重连
- **生命周期管理**: 自动处理资源清理

这样，用户只需要关注业务逻辑，而不需要处理复杂的 MCP 协议细节。这个 SDK 的设计目标是：

1. **简化复杂性**: 将原本需要 6 个步骤的复杂配置简化为几行代码
2. **提供默认值**: 为大部分配置项提供合理的默认值
3. **保持灵活性**: 允许高级用户自定义配置
4. **错误处理**: 内置错误处理和重连机制
5. **类型安全**: 提供完整的 TypeScript 类型支持

主要简化的方面：

- **客户端初始化**: 从复杂的多步骤配置简化为单个 `initialize()` 调用
- **工具注册**: 从复杂的 zod 类型定义简化为简单的参数对象
- **长任务处理**: 内置进度报告和取消机制
- **资源管理**: 简化资源注册和更新流程
- **错误处理**: 自动处理连接错误和重连
- **生命周期管理**: 自动处理资源清理

这样，用户只需要关注业务逻辑，而不需要处理复杂
npm package: @kagol/next-vue
Description: App.vue
Latest version: 0.0.2

# @opentiny/next-vue

## 快速开始

App.vue

```typescript
import { useNextClient } from '@opentiny/next-vue'

const { sessionId } = useNextClient({
  clientOptions: { name: 'my-project', version: '1.0.0' },
  proxyOptions: { url: 'http://xxx/sse' }
})
```

MyPage.vue

```typescript
import { useNextServer } from '@opentiny/next-vue'

const { server } = useNextServer({
  serverOptions: { name: 'company-list', version: '1.0.0' }
})
```