Trackleaf MCP

轨迹叶光标mcp

轻量级MCP（模型上下文协议）实现，通过stdio MCP服务器公开Trackleaf Cursor问题API。

快速链接

• 入口点： trackleaf_mcp.py
• 包装：trackleaf_mcp_pkg/
• Dockerfile:

需求

• Python 3.11+
• 安装依赖项：

python -m pip install -r requirements.txt

环境

• 服务器需要一个必需的和一个可选的环境变量：

- TRACKLEAF_PAT （必需）-具有Cursor API权限的个人访问令牌 - TRACKLEAF_BASE_URL （可选）--Trackleaf实例的基本URL（默认为https://www.api.trackleaf.in/)

在本地运行

使用附带的包装器启动MCP（它运行stdio MCP服务器）：

Windows（PowerShell）：

$env:TRACKLEAF_BASE_URL = "https://www.api.trackleaf.in/"
$env:TRACKLEAF_PAT = "sk_xxx"
python trackleaf_mcp.py

Linux/macOS：

export TRACKLEAF_BASE_URL=https://www.api.trackleaf.in/
export TRACKLEAF_PAT=sk_xxx
python trackleaf_mcp.py

码头工人

在本地构建映像：

docker build -t trackleaf-mcp:latest .

运行容器（传递env变量）：

docker run --rm -e TRACKLEAF_BASE_URL=https://www.api.trackleaf.in/ -e TRACKLEAF_PAT=sk_xxx trackleaf-mcp:latest

注意：您稍后提到了推送到Docker Hub——本README暂时省略了推送步骤。

IDE集成（MCP配置）

此MCP实现通过stdio进行通信。大多数IDE集成都需要一个小的JSON文件来描述如何启动MCP进程。下面是示例 mcp.json 文件和IDE特定提示。放置所选内容 mcp.json 在项目根目录旁边，或者按照IDE的说明指向它。

共同 mcp.json （通用）

{
  "name": "trackleaf-cursor-mcp",
  "version": "0.1.0",
  "description": "Trackleaf Cursor MCP (stdio)",
  "run": {
    "command": "python",
    "args": ["trackleaf_mcp.py"]
  },
  "stdio": true,
  "env": {
    "TRACKLEAF_BASE_URL": "https://www.api.trackleaf.in/",
    "TRACKLEAF_PAT": ""
  }
}

光标（PHEMIDE/光标兼容编辑器）

• Cursor支持通过指向加载MCP mcp.json 文件或配置自定义工具。使用通用 mcp.json 上面。确保Cursor已配置为运行 command 随着 args 并使用stdio。

VS Code

• VS Code有一些与MCP相关的扩展（例如，游标集成或其他MCP客户端）。如果您的分机接受 mcp.json 文件，使用Common mcp.json 上面。

如果扩展需要显式的VS代码设置，请在工作区中添加一个小代码段 settings.json （示例——根据扩展进行调整）：

{
  "mcp.server": {
    "trackleaf-cursor-mcp": {
      "command": "python",
      "args": ["${workspaceFolder}/trackleaf_mcp.py"],
      "stdio": true,
      "env": {
        "TRACKLEAF_BASE_URL": "https://www.api.trackleaf.in/",
        "TRACKLEAF_PAT": ""
      }
    }
  }
}

反重力

• 实现MCP运行器的反重力兼容客户端应该能够使用Common mcp.json.将IDE指向该文件，并确保它启动给定的 command 和 args 并使用stdio。

精确字段注释

• command：可执行以运行（例如。， python).
• args：参数数组；在这个仓库中，包装器是 trackleaf_mcp.py 其导入模块化封装。
• stdio：设置为 true 表示代理使用stdio传输。
• env：服务器所需的环境值。为了安全起见，不要将机密提交给VCS——最好通过IDE运行配置或环境设置它们。

故障排除

• 缺少env变量：进程将引发 Missing required env var 如果 TRACKLEAF_PAT 未设置。
• 依赖性错误：确保 requirements.txt 安装在您的环境中（或Docker镜像中）。
• 如果IDE无法启动服务器，请尝试运行 python trackleaf_mcp.py 手动确认它在没有IDE的情况下启动。

开发说明

• 模块化代码位于 trackleaf_mcp_pkg/ 随着 runner.py, client.py, server_tools.py 和 utils.py.

联系人/贡献

• 针对此存储库的未决问题或PR。如果您添加了对特定IDE集成的支持（例如，VS Code扩展配置），请在下面添加一个示例 docs/ 并从README链接它。

trackleaf mcp

Trackleaf的官方MCP服务器