MCP Woffu Server

MCP Woffu服务器

用于Woffu时间跟踪集成的模型上下文协议（MCP）服务器。该服务器允许像Claude这样的人工智能助手与您的Woffu帐户进行交互，以进行打卡/打卡操作和时间跟踪管理。

特性

• 打卡上班/下班：用简单的命令开始和结束你的工作日
• 今天的状态：检查您当前的工作状态、工作时间和日程安排
• 周/月摘要：全面了解你的工作时间
• 完成过去几天：填写过去日期缺少的时间条目
• 待定天数：查看没有记录小时数的天数

安装

使用GitHub上的npx（推荐）

npx github:iflorit/mcp-woffu-server

从GitHub全局安装

npm install -g github:iflorit/mcp-woffu-server
mcp-woffu-server

来源

git clone https://github.com/iflorit/mcp-woffu-server.git
cd mcp-woffu-server
npm install
npm run build

配置

服务器需要以下环境变量：

如何获取您的Woffu JWT代币

1. 登录您的Woffu门户网站（例如。， https://mycompany.woffu.com)
2. 打开浏览器开发工具（F12）
3. 去 应用 选项卡（Chrome）或 存储 选项卡（Firefox）
4. 在左侧面板中，展开 Cookie
5. 点击您的Woffu域名（例如。， https://mycompany.woffu.com)
6. 查找名为的cookie woffu.token
7. 复制值-这是你的 WOFFU_TOKEN

通过控制台选择：

document.cookie.split(';').find(c => c.trim().startsWith('woffu.token=')).split('=')[1]

备注：JWT令牌会定期过期。令牌过期时，您可能需要刷新令牌。

如何查找您的用户名

用户ID嵌入在JWT令牌中。你可以在以下网址解码 jwt.io 并寻找 UserId 有效载荷中的字段。

或者：

1. 在浏览器“开发人员工具”中，转到 网络 标签
2. 在Woffu中执行任何操作
3. 查看任何API请求URL-它通常包含您的用户ID（例如。， /api/users/1234567/...)

用法

使用克劳德桌面

将以下内容添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "github:iflorit/mcp-woffu-server"],
      "env": {
        "WOFFU_TOKEN": "your-jwt-token-here",
        "WOFFU_USER_ID": "your-user-id",
        "WOFFU_BASE_URL": "https://mycompany.woffu.com"
      }
    }
  }
}

使用克劳德代码

claude mcp add woffu --env WOFFU_TOKEN=your-token --env WOFFU_USER_ID=your-id --env WOFFU_BASE_URL=https://mycompany.woffu.com -- npx -y github:iflorit/mcp-woffu-server

或添加到您的 .claude.json:

{
  "mcpServers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "github:iflorit/mcp-woffu-server"],
      "env": {
        "WOFFU_TOKEN": "your-jwt-token-here",
        "WOFFU_USER_ID": "your-user-id",
        "WOFFU_BASE_URL": "https://mycompany.woffu.com"
      }
    }
  }
}

直接运行服务器

# With environment variables
export WOFFU_TOKEN="your-token"
export WOFFU_USER_ID="your-user-id"
export WOFFU_BASE_URL="https://mycompany.woffu.com"

# Run the server
npx github:iflorit/mcp-woffu-server

可用工具

woffu_clock_in

打卡开始你的工作日。

参数：无

示例响应:

{
  "status": "success",
  "action": "clock_in",
  "timestamp": "2024-01-15T09:00:00",
  "signEventId": "12345"
}

woffu_clock_out

打卡结束你的工作日。

参数：无

示例响应:

{
  "status": "success",
  "action": "clock_out",
  "timestamp": "2024-01-15T18:00:00",
  "signEventId": "12346"
}

woffu_status

获取今天的工作状态，包括日程安排和工作时间。

参数：无

退货：详细的工作日信息，包括：

• 当前时钟状态
• 今天工作时间
• 预计小时数
• 休息时间

woffu_month_summary

获取特定月份的工作时间摘要。

参数:

• year （可选）：年份（默认为当前年份）
• month （可选）：第1-12个月（默认为当月）

退货：每月出席情况总结，包括每日明细。

woffu_week_summary

获取每周工作时间摘要。

参数:

• date （可选）：所需周内的任何日期，格式为YYYY-MM-DD

退货：每周出席情况总结，包括每日明细。

woffu_day_detail

获取特定日期的详细信息。

参数:

• date （可选）：YYYY-MM-DD格式的日期（默认为今天）

退货：详细的日期信息，包括所有时钟事件。

woffu_pending_days

获得没有完成小时数的天数。

参数:

• year （可选）：年份（默认为当前年份）
• month （可选）：第1-12个月（默认为当月）

退货：未记录工时的工作日列表。

woffu_schedule

获取用户分配的工作时间表。

参数：无

退货：日程信息，包括工作时间和办公室详细信息。

woffu_complete_day

填写或编辑过去一天的时间条目。

参数:

• date：YYYY-MM-DD格式的日期
• slots：时隙列表 in_time 和 out_time （HH:MM格式）

示例:

{
  "date": "2024-01-10",
  "slots": [
    {"in_time": "09:00", "out_time": "14:00"},
    {"in_time": "15:00", "out_time": "18:00"}
  ]
}

与克劳德的对话示例

“把我送到沃夫家”

“我今天的工作状态如何？”

“显示2024年11月的工作时间”

“我昨天忘了打卡。你能填2024-01-14的9:00-14:00和15:00-18:00吗？”

“显示我本月的待处理天数”

发展

设置

git clone https://github.com/iflorit/mcp-woffu-server.git
cd mcp-woffu-server
npm install

建筑

npm run build

在开发中运行

npm run dev

安全说明

• 永远不要提交JWT令牌 到版本控制
• 使用环境变量或安全密钥管理
• JWT令牌过期-从 woffu.token 需要时使用cookie
• 默认情况下，服务器只接受本地连接

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

贡献

欢迎投稿！请随时提交拉取请求。

致谢

• 与 模型上下文协议 软件开发工具包
• 与集成 沃夫 时间追踪