Thoughtspot Admin MCP

thoughtspot管理员mcp

通过Claude Desktop提供ThoughtSpot管理功能的模型上下文协议（MCP）服务器。此服务器允许您搜索和分析ThoughtSpot实例中的元数据，包括直播板、答案、逻辑表、连接、标签和用户组。

特性

• 元数据搜索：使用过滤功能搜索所有ThoughtSpot元数据类型
• 用户和组管理：列出、搜索和管理用户和组
• 高级过滤：按元数据类型、作者、标签和其他条件筛选
• 分页支持：处理带有偏移和限制参数的大型结果集
• 使用情况分析：访问视图计数和上次访问时间戳
• 内容治理：分析内容分发和标记策略
• 权限管理：在组中添加和删除用户

可用工具

search-metadata

使用灵活的过滤选项搜索ThoughtSpot元数据对象。

参数：

• types （可选）：要搜索的元数据类型数组

- 有效类型： LIVEBOARD, ANSWER, LOGICAL_TABLE, CONNECTION, TAG, USER_GROUP - 留空以搜索所有类型

• authors （可选）：要筛选的作者姓名数组
• tags （可选）：要筛选的标记名称数组
• offset （可选）：分页的记录偏移量（默认值：0）
• limit （可选）：要返回的最大记录数（默认值：100，最大值：1000）

退货：

• 元数据ID和对象ID
• 对象名称和类型
• 作者信息
• 创建和修改时间戳
• 关联标签
• 使用统计数据（浏览次数、上次访问次数）
• 对象描述

list-users

列出具有可选过滤功能的ThoughtSpot用户。

参数：

• user_identifier （可选）：按用户标识符（用户名/电子邮件）过滤
• display_name （可选）：按显示名称筛选
• name_pattern （可选）：按名称模式过滤（支持“Bill\*”等通配符）
• email （可选）：按电子邮件地址筛选
• group_identifiers （可选）：按组标识符筛选（属于这些组的用户）
• offset （可选）：分页的记录偏移量（默认值：0）
• limit （可选）：要返回的最大记录数（默认值：100，最大值：1000）

注： 必须至少提供一个过滤器（user_identifier、display_name、name_pattern、电子邮件或group_identifiers）。

退货：

• 用户ID、名称和显示名称
• 电子邮件地址和帐户状态
• 帐户类型和权限
• 组成员资格和继承的组
• 创建和修改时间戳

list-groups

列出ThoughtSpot组，包括可选的筛选和用户包含。

参数：

• display_name （可选）：按组显示名称筛选
• group_identifier （可选）：按组标识符筛选
• name_pattern （可选）：按名称模式过滤（支持通配符）
• include_users （可选）：将用户包含在每个组中（默认值：false）
• include_sub_groups （可选）：包括子组（默认值：false）
• offset （可选）：分页的记录偏移量（默认值：0）
• limit （可选）：要返回的最大记录数（默认值：100，最大值：1000）

退货：

• 组ID、名称和显示名称
• 组描述和类型
• 系统组状态和权限
• 组中的用户列表（如果include_users=true）
• 创建和修改时间戳

manage-user-groups

在ThoughtSpot中添加或删除组中的用户。

参数：

• username （必填）：要管理的用户的用户名/电子邮件
• operation （必填）：要执行的操作-“添加”将用户添加到组中，“删除”将用户从组中删除
• group_identifiers （必填）：要添加/删除用户的组标识符列表

退货：

• 成功状态和操作细节
• 已执行操作的确认消息
• 受影响的用户名和组标识符

安装

1. 克隆此存储库：

git clone 
cd thoughtspot-admin-mcp

1. 安装依赖项：

pip install -r requirements.txt

Claude桌面配置

1.创建MCP配置文件

为Claude Desktop创建配置文件。位置取决于您的操作系统：

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

Linux：

~/.config/Claude/claude_desktop_config.json

2.添加MCP服务器配置

将以下配置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "thoughtspot-admin": {
      "command": "python",
      "args": [
        "/path/to/thoughtspot-admin-mcp/thoughtspot_admin_mcp.py",
        "--tsurl", "https://your-thoughtspot-server.cloud",
        "--username", "your-username",
        "--token", "your-api-token"
      ]
    }
  }
}

请注意，您可能需要指定安装了要求的Python环境的完整路径。

替换以下值：

• /path/to/thoughtspot-admin-mcp/：此存储库的完整路径
• https://your-thoughtspot-server.cloud：您的ThoughtSpot服务器URL
• your-username：您的ThoughtSpot用户名
• your-api-token：您的ThoughtSpot API代币

3.生成API令牌

获取ThoughtSpot API代币：

1. 登录您的ThoughtSpot实例
2. 首选 开发者 → REST Playground v2.0 → 认证 → 获取完全访问令牌
3. 使用您的用户名、密码和有效期创建新令牌。更长的时间可能是明智的，这样它就不会过期。
4. 复制令牌值以在配置中使用

4.重新启动克劳德桌面

更新配置文件后，重新启动Claude Desktop以使更改生效。

使用示例

查找所有Liveboards

Search for all liveboards in the system

按特定作者查找内容

Find all content created by john.doe

查找具有特定标签的对象

Find all objects tagged with "Finance" or "Marketing"

分析使用模式

Find liveboards with low usage (less than 10 views)

内容审计

Find all objects that haven't been accessed in the last 30 days

用户管理示例

查找所有用户

List all users in the system

按名称模式查找用户

Find users whose names start with "Bill"

查找特定组中的用户

Find all users who belong to the "Developers" group

集团管理示例

列出所有组

List all groups in the system

列出用户组

List all groups and include the users in each group

用户组管理示例

将用户添加到组

Add user john.doe@company.com to the "Developers" group

从组中删除用户

Remove user john.doe@company.com from the "Analysts" group

将用户添加到多个组

Add user john.doe@company.com to both "Developers" and "Analysts" groups

发展

测试连接

您可以测试与ThoughtSpot实例的连接：

python thoughtspot_admin_mcp.py --tsurl https://your-server.cloud --username your-username --token your-token --test

这将获取所有直播板和答案，并将其作为JSON输出。

直接运行服务器

用于开发或调试：

python thoughtspot_admin_mcp.py --tsurl https://your-server.cloud --username your-username --token your-token

需求

• Python 3.10或更高版本
• ThoughtSpot REST API v1库
• MCP库
• 具有API访问权限的有效ThoughtSpot实例

安全说明

• 安全存储您的API令牌
• 在生产中使用环境变量进行敏感配置
• 定期轮换您的API代币
• 确保您的ThoughtSpot实例具有适当的安全配置

故障排除

常见问题

1. 连接失败：验证您的ThoughtSpot URL、用户名和令牌
2. 权限不足：确保您的API令牌具有适当的权限
3. 无效网址：确保URL以开头 http:// 或 https://
4. Python路径：确保在MCP配置中指定了正确的Python解释器

调试日志记录

服务器在中创建调试日志 mcp_debug.log （或 /tmp/mcp_debug.log 如果当前目录不可写）。检查此文件以获取详细的错误信息。

许可证

MIT许可证