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"
      }
    }
  }
}

可用工具

将军

账户

设备（计算机和联系人）

群组

用户

会话（服务队列）

连接报告

设备报告（传入会话）

会议

政策

示例提示

一旦连接到克劳德：

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

令牌权限

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

API 参考

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

许可证

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

学分

• 作者：拉杰什·胡里亚
• MCP框架: 模型上下文协议Python SDK
• TeamViewer Web API: TeamViewer API文档