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返回状态代码和错误详细信息
- 如果找不到指定的资源（工作区、组等），则显示专用错误消息