Toggl MCP Server

🚀 从零开始使用 MCP Toggl Server（中文版）

本项目提供了与 Toggl Track 集成的服务，支持通过 VS Code 和 GitHub Copilot 进行开发工具集成，还提供了详细的安装和配置指导。

🚀 快速开始

要使用 MCP Toggl Server，你需要完成安装和配置。以下是详细步骤：

1. 完成先决条件的准备。
2. 配置环境变量。
3. 按照安装步骤完成安装。

✨ 主要特性

• 支持与 Toggl Track 集成。
• 提供详细的安装和配置指导。
• 支持通过 VS Code 和 GitHub Copilot 进行开发工具集成。

📦 安装指南

先决条件

• Python 3.11+ 版本
• Toggl Track 账户
• 已安装 uv 用于依赖管理

环境变量配置

在 mcp_toggl_server 文件夹中创建一个 .env 文件：

EMAIL=your_toggl_email
PASSWORD=your_toggl_password

安装步骤

1. 安装 uv：
   • 对于 MacOS/Linux 系统，请运行以下命令：

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • 对于 Windows 系统，请运行以下命令：

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

2. 重启终端以确保 uv 命令生效。
3. 克隆代码仓库并设置项目：

   git clone [repository-url]
   cd mcp_toggl_server
   uv venv
   uv pip install --all
   

📚 详细文档

开发工具集成

VS Code + GitHub Copilot 设置

1. 配置 MCP 服务器： 在 .vscode/mcp.json 文件中添加以下内容：

   "servers": {
     "toggl": {
       "type": "stdio",
       "command": "uv",
       "args": [
         "--directory",
         "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server",
         "run",
         "toggl_mcp_server.py"
       ],
       "envFile": "${workspaceFolder}/mcp_toggl_server/.env"
     }
   }
   

2. 更新配置：
   • 将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server 替换为实际路径。
   • 如果需要，可以在 command 字段中指定 uv 可执行文件的完整路径。可以通过运行 which uv（Mac/Linux）或 where uv（Windows）来获取路径。
3. 启用服务器：
   • 鼠标悬停在 MCP 服务器配置上，点击开始按钮以让 Copilot 发现可用工具。
   • 切换到 Agent 模式使用 Copilot。

其他 MCP 客户端集成

1. 对于 Claude Desktop，请参考 MCP 快速入门指南。
2. 对于其他 MCP 客户端，请参阅其相应文档进行配置，通常需要指定服务器路径和环境变量。

测试与开发

运行以下命令以测试：

EMAIL=your_toggl_email PASSWORD=your_toggl_password mcp dev toggl_mcp_server.py

附录：使用指南

常见问题解答

1. 如何获取 Toggl 账户？
   • 请访问 Toggl 官网注册并登录。
2. 安装 uv 出现错误怎么办？
   • 确保网络连接正常，或者尝试更换镜像源。
3. 配置 .env 文件时需要注意什么？
   • 确保文件路径正确，并且变量名与文档一致。

联系方式

• 有问题或反馈请联系：support@yourdomain.com

更多资源

1. Toggl 官网
2. uv 工具文档
3. GitHub Copilot 文档

📄 许可证

（此处应填写具体的许可协议内容）