工时表自动填写服务

一款基于MCP协议的Workday工时表自动填写服务器,支持自动提交和状态跟踪。

  • by albertnahas
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 albertnahas/worday-timesheet-mcp-server

使用说明

工作日时间表MCP服务器

用于自动填写工作日时间表的服务器。

什么是MCP?

这 模型上下文协议(MCP) 是一种开放协议,可实现LLM应用程序和外部工具之间的无缝集成。

特性

工作日时间表

  • 自动填写并提交时间表
  • 跟踪时间表提交状态

先决条件

  • Python 3.12或更高版本
  • Anthropic API密钥或其他受支持的LLM提供商

设置

  1. 确保已激活虚拟环境:

    uv venv
    source .venv/bin/activate  # On Unix/Mac
    
  2. 安装所需的软件包:

    uv pip install -r requirements.txt
    playwright install
    
  3. 更新 .env 使用API密钥文件:

    ANTHROPIC_API_KEY=your_openai_api_key_here
    
  4. 添加您组织的Workday URL(例如。,https://wd3.myworkday.com/company/d/home.htmld)

    例子:

    WORKDAY_URL=https://wd3.myworkday.com/company/d/home.htmld
    

备注

由于我们使用stdio作为MCP传输,我们禁用了浏览器使用的所有输出

调试

您可以使用以下命令运行MCP检查器工具

uv run mcp dev server.py

您可能需要启动启用了远程调试的Chrome实例:

/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug

这允许自动化工具连接到现有的Chrome实例。

使用示例

工作日时间表

填写时间表:

await fill_timesheet(
    week_start_date="2025-05-05",
    days_off="Monday"
    time_types="Admin",
)

检查时间表提交状态:

resource://timesheet_status/request_id