使用说明

项目简介

Eyevinn Open Source Cloud MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型 (LLM) 客户端提供与 Eyevinn Open Source Cloud 平台集成的能力。通过此服务器,LLM 可以安全、可扩展地访问和管理云平台上的各种资源和服务,例如创建数据库、存储桶和视频点播 (VOD) 管道。

主要功能点

  • 云资源管理: 提供创建和管理云端数据库 (SQL, NoSQL, MemoryDb)、S3兼容存储桶以及VOD转码和打包管道的功能。
  • 工具调用: 注册并提供一系列工具,允许LLM客户端通过标准化的MCP协议调用云平台的功能,例如 'osc_create_db' 创建数据库,'osc_create_bucket' 创建存储桶,'osc_create_vod_pipeline' 创建VOD管道等。
  • 标准MCP协议: 使用 JSON-RPC over Stdio 与 MCP 客户端通信,遵循 MCP 协议规范,确保与支持 MCP 协议的 LLM 应用(如 Claude Desktop)的兼容性。
  • 资源访问: 提供对云平台资源的访问能力,例如列出活动服务、本地视频资源等。

安装步骤

该MCP服务器基于 Node.js 开发,并以 npm 包的形式发布,无需显式安装步骤,可以直接通过 'npx' 命令运行。但使用前需要确保已安装 Node.js 和 npm。

同时,使用该服务器需要拥有 Eyevinn OSC 账户和 Personal Access Token。如果您还没有账户,请先注册 Eyevinn OSC account。然后在 API settings 中创建并复制 Personal Access Token。

服务器配置

对于 MCP 客户端(例如 Claude Desktop),您需要配置 MCP 服务器的启动命令和参数。以下是针对 Eyevinn OSC MCP Server 的 'claude_desktop_config.json' 配置示例:

{
  "mcpServers": {
    "eyevinn-osc": {
      "command": "npx",
      "args": ["-y", "@osaas/mcp-server"],
      "env": {
        "OSC_ACCESS_TOKEN": "<YOUR_TOKEN>"  // 请替换为您的 Eyevinn OSC Personal Access Token
      }
    }
  }
}

配置参数说明:

  • 'server name': 'eyevinn-osc' (服务器名称,客户端用于标识和调用)
  • 'command': 'npx' (Node.js 包执行器,用于运行 npm 包)
  • 'args': '["-y", "@osaas/mcp-server"]' (运行 '@osaas/mcp-server' npm 包,'-y' 参数用于自动确认安装包)
  • 'env': 环境变量配置
    • 'OSC_ACCESS_TOKEN': '<YOUR_TOKEN>' (Eyevinn OSC Personal Access Token,请务必替换为您的真实 Token)

将上述配置添加到您的 'claude_desktop_config.json' 文件中,Claude Desktop 即可识别并连接到 Eyevinn OSC MCP 服务器。

基本使用方法

  1. 启动 MCP 服务器: 无需手动启动,当 Claude Desktop 等 MCP 客户端需要连接时,会根据配置自动通过 'npx' 命令启动。
  2. 配置 MCP 客户端: 在 MCP 客户端中配置上述服务器配置信息,确保客户端能够找到并连接到 Eyevinn OSC MCP 服务器。
  3. 使用工具: 客户端连接成功后,即可调用服务器提供的工具,例如在 Claude Desktop 中,您可以指示 Claude 使用 'osc_create_db' 工具创建数据库,或使用 'osc_create_bucket' 工具创建存储桶等。
  4. 访问资源: 客户端可以请求访问服务器提供的资源,例如获取 "My active services" 资源以查看您在 Eyevinn OSC 平台上已激活的服务列表。

请参考 Eyevinn Open Source Cloud 和您使用的 MCP 客户端的文档,了解更详细的工具和资源使用方法。

信息

分类

开发者工具