traecnclaw

Name: traecnclaw
Author: Luckycat133

本地服务

github.com/Luckycat133AI 与智能体05 天前更新

代码仓库

关于 traecnclaw

TRAECNclaw 是用于操作 Mac 上 TraeCN 桌面应用的本地 MCP 服务和 Agent Skill。它提供 20 个稳定工具，并由本地网关管理任务排队、恢复与完成状态。

主要功能

0120 个稳定的单一用途 MCP 工具
02本地 stdio 服务与网关
03操作 TraeCN 桌面应用
04网关管理排队与恢复
05支持安装 Agent Skill

适用场景

01从 Agent 主机向 TraeCN 发送编码任务
02按需打开工作区或选择模型
03恢复任务并跟踪持久化完成状态

MCP 相关

通过本地 stdio 服务向 MCP 客户端提供 20 个工具。它与 TraeCN 在同一台 Mac 上的网关协作，并兼容多个 MCP 客户端协议版本。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "luckycat133-traecnclaw": {
      "command": "npx",
      "args": [
        "-y",
        "@luckycat133/traecnclaw"
      ],
      "env": {
        "TRAECN_GATEWAY_HOST": "<TRAECN_GATEWAY_HOST>",
        "TRAECN_GATEWAY_PORT": "<TRAECN_GATEWAY_PORT>",
        "TRAECN_GATEWAY_TOKEN": "<TRAECN_GATEWAY_TOKEN>"
      }
    }
  }
}

启动命令npx -y @luckycat133/traecnclaw

需要配置的环境变量

TRAECN_GATEWAY_HOSTGateway host; keep loopback unless remote access is authenticated.

TRAECN_GATEWAY_PORTGateway port.

TRAECN_GATEWAY_TOKEN密钥Gateway bearer token.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@luckycat133/traecnclaw0.6.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

TRAECNclaw MCP 技能

根据 commit 40bcf7707ed9b0ff7938aea8e511d0b87d300705 中的规范版 TRAECNclaw 0.6.0 生成。

TRAECNclaw 是一个本地优先的 MCP 服务和 Agent 技能，用于操作用户 Mac 上的 TraeCN 桌面应用。本仓库是公开分发镜像：其中包含可移植的技能、可安装的服务压缩包、来源证明和市场元数据，但不会公开私有的规范版历史记录。

TRAECNclaw 提供 MCP 合约版本 5，包含且仅包含 20 个稳定的单一意图工具。常规 Agent 工作流如下：

仅在需要时打开工作区。
仅在需要时选择模型或模式。
发送一条消息，然后释放调用方上下文。
旧版 MCP 客户端会收到持久通知；现代 2026-07-28 主机可以协商 Tasks，并订阅精确返回的任务 ID。

排队、等待、恢复、常规非命令类问题、任务所有权和持久完成均由网关管理。

本地服务使用以换行符分隔的 stdio，实现 MCP 2026-07-28，并保持与基于初始化的 2025-11-25 和 2024-11-05 客户端兼容。TRAECNclaw 合约版本 5 是工具接口版本，而非 MCP 协议修订版。独立协商的上游草案 io.modelcontextprotocol/tasks 扩展不会增加工具。

安装服务

通过一种已验证的渠道安装准确的发行版：

npm install --global @luckycat133/[email protected]
# or, after `brew info` reports 0.6.0
brew install Luckycat133/tap/traecnclaw

对应的 GitHub Release 还提供完整的限定范围 npm 压缩包和确定性 MCPB 包。无关的无范围 [email protected] 包属于历史版本，并非当前安装方式。

Homebrew 兼容性过渡

本仓库还包含 Formula/traecnclaw.rb，它是从现有公开的 0.6.0 tap 逐字节复制而来。过渡期间，Luckycat133/homebrew-tap 仍可使用。现有安装不会自动更改。更改 tap 远程地址前，请参阅迁移、检查和回滚。技能、源代码修订版和历史发行版下载均保持不变。

安装 Agent 技能

使用开放的 Skills CLI 从公开的 GitHub 仓库安装：

npx skills add https://github.com/Luckycat133/traecnclaw-mcp-skill \
  --skill traecnclaw-mcp \
  -g

或者从 GitHub Release 下载对应的技能压缩包。技能位于 .codex/skills/traecnclaw-mcp，包含 assets/mcp-client-config.json、scripts/setup-mcp.js 和服务启动器。安装或更新技能后，请重启 Agent 主机。

使用 scripts/setup-mcp.js 验证服务发现并生成主机条目。常规运行方式如下：

Agent host -> local stdio server -> gateway on the same Mac -> TraeCN

服务和网关与 TraeCN 一样，运行在用户拥有的同一台 Mac 上。市场容器可以检查 stdio 架构，但云端容器无法透明地控制用户本地的 TraeCN 桌面应用。

准备好的 Official Registry 元数据使用限定范围的包 @luckycat133/[email protected]，并采用本地 stdio 传输。Smithery Local 使用对应的已验证 MCPB 包；已弃用的 smithery.yaml 格式仍未包含在内。

配置

网关默认值为 TRAECN_GATEWAY_HOST=127.0.0.1 和 TRAECN_GATEWAY_PORT=8788。绑定到非回环地址时必须设置 TRAECN_GATEWAY_TOKEN。没有 MCP 工具配置文件设置。

发现渠道

同一个公开仓库是技能和 MCP 目录提交的规范来源。只有当目录条目的版本、本地 stdio 传输、macOS 要求、20 个工具的数量和生成的安装命令均与此发行版一致时，该条目才值得信赖。

选定的渠道包括 ClawHub、Glama、skills.sh、AwesomeSkills.dev、MCP.Directory、MCPB/Smithery Local，以及在当前公开包发布后加入的 Official MCP Registry 和 PulseMCP。其他目录应沿用相同的来源证明和安装说明，而不是维护分支版本。