时间追踪MCP服务器

一个非官方的模型上下文协议(MCP)服务器,提供对EARLY应用程序时间追踪公共API的访问。

  • by janfincke
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 janfincke/early-mcp-server

使用说明

早期应用程序MCP服务器

一个非官方的模型上下文协议(MCP)服务器,提供对EARLY应用程序时间跟踪公共API的访问。

概述

EARLY是一个具有全面的公共API的时间跟踪应用程序。该MCP服务器使人工智能助手能够通过公共EARLY API与时间跟踪数据进行交互。

工具

时间录入管理

  • create_time_entry -使用灵活的时间参数创建新的时间条目
  • edit_time_entry -编辑现有时间条目
  • get_time_entries -获取日期范围的时间条目
  • delete_time_entry -按ID删除时间条目
  • start_timer -开始跟踪项目的时间
  • stop_timer -停止当前正在运行的计时器
  • get_active_timer -获取有关当前正在运行的计时器的信息
  • update_active_timer -更新当前运行计时器的描述

活动管理

  • list_activities -获取所有活动
  • create_activity -创建新活动(项目)
  • update_activity -更新现有活动
  • archive_activity -存档或删除活动

用户和报告

  • generate_report -为时间条目生成摘要报告
  • get_current_user -获取当前用户信息

资源

时间条目

  • early://time-entries/today -今天的时间条目,包含详细的JSON数据
  • early://time-entries/week -本周时间条目

活动

  • early://activities -所有活动(活动+非活动+存档)
  • early://activities/active -仅限活动

快速开始

安装

无需安装!使用npx运行服务器:

npx @janfincke/early-mcp-server

配置(适用于Claude Desktop和其他)

{
  "mcpServers": {
    "early-time-tracker": {
      "command": "npx",
      "args": [
        "@janfincke/early-mcp-server"
      ],
      "env": {
        "EARLY_API_KEY": "your-early-api-key-here",
        "EARLY_API_SECRET": "your-early-api-secret-here"
      }
    }
  }
}

从EARLY桌面应用程序获取API凭据: 设置→ 开发者→ API密钥

文档

完整的文件

综合文档可在以下网址获得 janfincke.github.io/早期mcp-server 包括:

早期API文档

  • 基础URL: https://developers.early.app/
  • 文档:邮差收藏
  • 认证:API密钥(假设)

贡献

  1. 克隆该仓库
  2. 创建要素分支
  3. 进行更改
  4. 添加测试
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件。