AI导哈

TeamViewer MCP 服务器

一个将 TeamViewer Web API v1 暴露为可被 Claude 和其他 MCP 客户端调用的工具的 MCP 服务器。

  • by teamviewer
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 RajeshHuria/teamviewer-mcp-server

使用说明

TeamViewer MCP服务器

⚠️ ALPHA——使用风险自负

该项目正在进行中 阿尔法阶段 并且按原样提供，不提供任何形式的保证或支持。

  • 重大变更可能随时发生，恕不另行通知
  • 没有保证正常运行时间、稳定性或数据安全性
  • 作者接受 不承担任何责任或义务 因使用本软件而造成的任何损坏、数据丢失、帐户问题或任何其他后果
  • 使用完全由您自行承担风险

一个MCP（模型上下文协议）服务器，它公开 TeamViewer Web API v1 作为Claude和其他MCP客户端可调用的工具。

托管实例可供任何人使用，无需设置。只需携带自己的TeamViewer脚本令牌：

🌐 https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/

访问上面的URL，粘贴您的令牌，并获得一个个人MCP服务器URL，准备插入Claude或任何其他MCP兼容客户端。

先决条件

  • Python 3.10+
  • 具有以下权限的TeamViewer帐户 商务、高级、企业或张量 计划
  • A. 脚本令牌 （或OAuth 2.0访问令牌）

创建脚本令牌

  1. 登录到 登录Teamviewer.com
  2. 单击您的帐户名→ 编辑个人资料
  3. 首选 应用 → 创建脚本令牌
  4. 选择所需的权限并保存令牌

连接到托管服务器

最快的入门方法——无需安装。使用带有您自己的TeamViewer脚本令牌的托管实例。

步骤1--获取您的个人MCP URL

访问 https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/，粘贴您的脚本令牌，并复制生成的URL。它看起来像：

https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN

第二步——连接您的客户端

克劳德桌面

将以下内容添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "teamviewer": {
      "type": "sse",
      "url": "https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN"
    }
  }
}

重新启动Claude Desktop——TeamViewer工具将自动出现。

克劳德代码

claude mcp add --transport sse teamviewer \
  "https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN"

开爪

openclaw mcp set teamviewer '{
  "url": "https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN"
}'

OpenAI代理SDK

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

TV_MCP_URL = "https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN"

async def main():
    async with MCPServerSse(name="teamviewer", params={"url": TV_MCP_URL}, cache_tools_list=True) as tv:
        agent = Agent(
            name="TeamViewer Assistant",
            model="gpt-4o",
            instructions="You help manage TeamViewer devices and sessions.",
            mcp_servers=[tv],
        )
        result = await Runner.run(agent, "List all my online TeamViewer devices")
        print(result.final_output)

asyncio.run(main())

请先安装SDK： pip install openai-agents

OpenAI响应API

from openai import OpenAI

client = OpenAI()  # uses OPENAI_API_KEY env var

response = client.responses.create(
    model="gpt-4o",
    tools=[{
        "type": "mcp",
        "server_label": "teamviewer",
        "server_url": "https://teamviewer-mcp.victoriousgrass-fb6499b5.westeurope.azurecontainerapps.io/sse?token=YOUR_TOKEN",
        "require_approval": "never",
    }],
    input="List all my online TeamViewer devices"
)
print(response.output_text)

自托管（本地设置）

如果您更喜欢自己运行服务器：

pip install -e .
export TEAMVIEWER_API_TOKEN="your_token_here"
mcp-teamviewer

使用Claude Desktop（本地）

{
  "mcpServers": {
    "teamviewer": {
      "command": "mcp-teamviewer",
      "env": {
        "TEAMVIEWER_API_TOKEN": "your_token_here"
      }
    }
  }
}

如果 mcp-teamviewer 如果不在PATH中（例如安装在本地venv中），请使用完整路径：

{
  "mcpServers": {
    "teamviewer": {
      "command": "/path/to/.venv/bin/mcp-teamviewer",
      "env": {
        "TEAMVIEWER_API_TOKEN": "your_token_here"
      }
    }
  }
}

可用工具

将军

工具 说明
ping 验证API令牌和连接

账户

工具 说明
get_account 获取当前帐户信息
update_account 更新帐户配置文件

设备（计算机和联系人）

工具 说明
list_devices 列出所有设备
get_device 获取特定设备的详细信息
update_device 更新设备别名、组或密码
delete_device 从“计算机和联系人”中删除设备

群组

工具 说明
list_groups 列出所有组
create_group 创建新组
update_group 重命名组或更改其策略
delete_group 删除组
share_group 与其他用户共享组

用户

工具 说明
list_users 列表管理控制台用户
create_user 创建新用户
get_user 获取特定用户的详细信息
update_user 更新用户配置文件或权限

会话（服务队列）

工具 说明
list_sessions 列出支持会话
create_session 创建新的支持会话
get_session 获取会话详细信息
update_session 更新会话描述
close_session 关闭打开的会话（将状态设置为关闭）
delete_session 永久删除会话
get_session_custom_module_config 获取会话的自定义模块配置ID
get_session_custom_modules_config_id 获取会话的自定义模块配置ID（备用端点）

连接报告

工具 说明
get_connection_reports 使用筛选器查询传出连接历史记录
get_connection_report 按ID获取单个连接报告
update_connection_report 更新连接报告上的注释
delete_connection_report 删除连接报告
list_connection_report_features 列出可用的功能筛选器选项
get_connection_report_features 获取一组报告ID的特征元数据
get_connection_report_feature_connections 获取按功能名称和ID筛选的报告
get_connection_report_feature_connection 获取按功能名称和ID筛选的单个报告
get_connection_report_ai_summary 获取AI生成的会话摘要 （需要张量计划）
get_connection_report_chat_transcript 获取会话的聊天记录 （需要张量计划）
get_connection_report_voice_transcript 获取会话的语音记录 （需要张量计划）
get_connection_report_augmented_summary 获取增强AI会话摘要 （需要张量计划）
list_connection_report_screenshots 列出会话期间捕获的屏幕截图
get_connection_report_screenshot 下载屏幕截图（返回base64）

设备报告（传入会话）

工具 说明
get_device_reports 使用筛选器查询传入会话报告
get_device_report_ai_summary 获取AI生成的传入会话摘要 （需要张量计划）
get_device_report_chat_transcript 获取传入会话的聊天记录 （需要张量计划）
list_device_report_features 列出设备报告的可用功能筛选器选项
get_device_report_features 获取一组设备报告ID的功能元数据
get_device_report_feature_connections 获取按功能名称和ID筛选的设备报告
get_device_report_feature_connection 获取按功能名称和ID筛选的单个设备报告

会议

工具 说明
list_meetings 列出已安排的会议
create_meeting 安排新会议
get_meeting 获取会议详细信息
update_meeting 更新会议
delete_meeting 删除会议

政策

工具 说明
list_policies 列出所有TeamViewer策略
get_policy 获取特定政策

示例提示

一旦连接到克劳德：

  • “列出我的所有在线TeamViewer设备”
  • “显示上周的连接报告”
  • “获取连接报告abc-123的AI摘要”
  • “下载我上次支持会话的聊天记录”
  • “列出会话报告xyz-456中的所有屏幕截图”
  • “在g12345组中创建支持会话”
  • “我的TeamViewer公司帐户中有哪些用户？”
  • “明天上午10点安排一个名为“团队同步”的会议”
  • “显示本月传入的设备会话报告”

令牌权限

所需的令牌权限取决于您使用的工具：

权限 需要
帐户访问权限 get_account, update_account
计算机和联系人 list_devices, get_device, update_device, delete_device
集团管理 list_groups, create_group, update_group, delete_group, share_group
用户管理 list_users, create_user, get_user, update_user
会话管理 list_sessions, create_session, get_session, update_session, close_session, delete_session, get_session_custom_module_config, get_session_custom_modules_config_id
连接报告 全部 get_connection_report*, update_connection_report, delete_connection_report, list_connection_report*, get_device_report*, list_device_report*
会议管理 list_meetings, create_meeting, get_meeting, update_meeting, delete_meeting
Tensor计划+AI功能 get_connection_report_ai_summary, get_connection_report_chat_transcript, get_connection_report_voice_transcript, get_connection_report_augmented_summary, get_device_report_ai_summary, get_device_report_chat_transcript

API 参考

完整的TeamViewer Web API文档：https://webapi.teamviewer.com/api/v1/docs/index

许可证

麻省理工学院——见 许可证

学分

相关 MCP