金大哥 - toggl-mcp-server MCP 详情

article

README

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

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

🚀 快速开始

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

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

✨ 主要特性

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

📦 安装指南

先决条件

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

环境变量配置

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

EMAIL=your_toggl_email
PASSWORD=your_toggl_password

安装步骤

安装 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"

重启终端以确保 uv 命令生效。

克隆代码仓库并设置项目：

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

📚 详细文档

开发工具集成

VS Code + GitHub Copilot 设置

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

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

其他 MCP 客户端集成

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

测试与开发

运行以下命令以测试：

EMAIL=your_toggl_email PASSWORD=your_toggl_password mcp dev toggl_mcp_server.py

附录：使用指南

常见问题解答

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

联系方式

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

📄 许可证

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

toggl-mcp-server