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 文檔

📄 許可證

（此處應填寫具體的許可協議內容）