早期MCP服务器
一个MCP（模型上下文协议）服务器，与 早 （Timeular v4）时间跟踪API。让像克劳德这样的人工智能助手可以完全访问时间跟踪、活动管理和分析。
特性
- 活动管理 -创建、更新、列出和删除活动
- 时间追踪 -启动/停止计时器，查看当前跟踪状态
- 时间条目 -查询、创建和删除手动时间条目
- 分析 -时间摘要、带差距检测的效率报告和计费报告
- API资源管理器 -对任何EARLY API端点的原始身份验证访问
工具
| 工具 | 说明 |
|---|---|
list_activities | 列出所有带有ID、名称和颜色的活动 |
create_activity | 创建新活动 |
update_activity | 更新现有活动的名称或颜色 |
delete_activity | 存档/删除活动 |
current_tracking | 获取当前正在运行的计时器 |
start_tracking | 开始跟踪活动的时间 |
stop_tracking | 停止当前跟踪器 |
list_time_entries | 查询日期范围内的时间条目 |
create_time_entry | 创建手动时间条目 |
delete_time_entry | 删除时间条目 |
time_summary | 一段时间内按活动汇总的小时数 |
efficiency_report | 分析时间分布并检测未跟踪的差距 |
billing_report | 按活动计算计费小时数和成本 |
explore_api | 向任何EARLY API端点发出原始身份验证请求 |
设置
先决条件
- Python 3.12+
- 紫外线 包管理器
- 早期开发人员API密钥和秘密
安装
git clone git@github.com:sakebomb/early_mcp.git
cd early_mcp
uv sync配置
创建一个 .env 使用EARLY API凭据提交文件：
EARLY_API_KEY=your_api_key
EARLY_API_SECRET=your_api_secret克劳德代码
将此添加到您的Claude Code MCP设置中(~/.claude/settings.json):
{
"mcpServers": {
"early": {
"command": "uv",
"args": ["run", "--directory", "/path/to/early_mcp", "python", "early.py"],
"env": {
"EARLY_API_KEY": "your_api_key",
"EARLY_API_SECRET": "your_api_secret"
}
}
}
}项目结构
early.py # MCP server with tool definitions
early_client.py # API client, auth, and utility functions
pyproject.toml # Project config and dependencies认证
服务器使用EARLY的开发人员登录流。它将API密钥/机密交换为承载令牌，将其缓存在内存中，并在到期时自动刷新。