AI导哈

虚拟空间管理服务器

一个与oVice API集成的MCP服务器，提供工作区、群组和用户管理以及通知功能，适用于组织内部协作和沟通。

  • by cti1650
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cti1650/ovice-mcp-server

使用说明

ovice MCP服务器

关于此存储库

在本地环境中MCP用于构建服务器的个人验证的非正式存储库（无法保证操作）

ovice API 协作，提供工作空间、组、用户管理和通知功能MCP服务器。

机能概要

这个MCP服务器提供以下功能：

  • 工作区管理：组织中的工作区列表检索、用户列表、访问URL生成
  • 组管理：组织中的组列表检索、成员管理
  • 通知机能：向组织、工作区和组发送通知
  • 情报取得：获取空间名称等

初期设定

克劳德桌面

编辑配置文件MCP注册服务器。

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ovice-mcp-server": {
      "command": "npx",
      "args": ["github:cti1650/ovice-mcp-server"],
      "env": {
        "OVICE_DOMAIN": "api.ovice.com",
        "OVICE_CLIENT_ID": "your-client-id",
        "OVICE_CLIENT_SECRET": "your-client-secret",
        "OVICE_ORGANIZATION_ID": "your-organization-id",
        "OVICE_SERVICE_NAME": "Your Service Name",
        "OVICE_SERVICE_LOGO_URL": "https://your-logo-url.com/logo.svg"
      }
    }
  }
}

环境变数

｜变量名｜必需｜默认值｜说明｜ |--------|------|-------------|------| | OVICE_CLIENT_ID | ✓ | - | oVice API客户机ID | | OVICE_CLIENT_SECRET | ✓ | - | oVice API客户端密码 | OVICE_ORGANIZATION_ID |✓| - |组织ID | | OVICE_DOMAIN ｜-｜“api.ovice.com”｜oVice API域（在生产环境以外需要变更）｜ | OVICE_SERVICE_NAME 在通知中显示的服务名称 | OVICE_SERVICE_LOGO_URL | - | oVice标志URL | 通知中显示的服务徽标URL |

可用工具

工作区关系

get_organization_workspaces

  • 说明：获取组织工作区列表
  • 参数：无
  • 返回值：工作区列表（JSON格式）

get_workspace_users

  • 说明：获取指定工作区的用户列表
  • 参数:
    • workspaceId (string): 工作区ID
  • 返回值：用户列表（JSON格式）

get_space_name_by_id

  • 说明：空格ID从中获取空间名称
  • 参数:
    • spaceId (string): 空间，空间ID
  • 返回值：空间名称

get_workspace_access_path

  • 说明：用于访问工作区URL生成
  • 参数:
    • workspaceId (string): 工作区ID
  • 返回值：访问URL (https://{appDomain}/ws/{workspaceDomain}/)
  • 备考: API中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长URL生成

组关系

get_organization_groups

  • 说明：获取组织的组列表
  • 参数：无
  • 返回值：组列表（JSON格式）

get_group_members

  • 说明：获取指定组的成员列表
  • 参数:
    • groupId (string): 组合ID
  • 返回值：成员列表（JSON格式）

通知机能

send_organization_notification

  • 说明：向整个组织发送通知
  • 参数:
    • message (string): 通知消息
    • serviceName (string, optional): 服务名称
    • serviceLogoUrl (string, optional): 服务标志URL
  • 返回值：送信结果（JSON形式）

send_workspace_notification

  • 说明：向特定工作区发送通知
  • 参数:
    • workspaceId (string): 工作区ID
    • auth (array): 被通知的权限级别（“admin”、“member”、“visitor”、“guest”）
    • message (string): 通知消息
    • serviceName (string, optional): 服务名称
    • serviceLogoUrl (string, optional): 服务标志URL
  • 返回值：送信结果（JSON形式）

send_group_notification

  • 说明：向特定组发送通知
  • 参数:
    • groupId (string): 组合ID
    • message (string): 通知消息
    • serviceName (string, optional): 服务名称
    • serviceLogoUrl (string, optional): 服务标志URL
  • 返回值：送信结果（JSON形式）

API仕様

这个MCP服务器是 o副公共API v1 使用：

  • 端点: https://{OVICE_DOMAIN}/api/public/v1/
  • 认证：客户端ID和客户端密码的页眉验证

错误处理

  • 如果环境变量不足，则显示相应的错误消息
  • API调用失败时HTTP返回状态代码和错误详细信息
  • 如果找不到指定的资源（工作区、组等），则显示专用错误消息

网站页面信息

相关 MCP