FreeAgent MCP Server
2025.03.05
1
JavaScript时间管理自动化工具日程管理
FreeAgent MCP Server 是一个基于 Claude MCP（Model Context Protocol）的服务器，用于管理与 FreeAgent 账户相关的时间记录和计时器操作。该服务器允许 Claude 与用户的 FreeAgent 账户进行交互，包括时间跟踪、计时器管理以及时间记录操作。
View on GitHub
Overview
基本能力
产品定位
FreeAgent MCP Server 是一个专门用于管理 FreeAgent 时间记录和计时器的服务，通过与 FreeAgent API 的交互，实现时间跟踪和管理的自动化。
核心功能
- 列出和筛选时间记录（支持嵌套数据）
- 创建新的时间记录
- 更新现有的时间记录
- 启动和停止计时器
- 删除时间记录
- 自动刷新 OAuth 令牌
- 全面的错误处理
- 支持 Docker 容器化部署
适用场景
- 个人或团队时间管理
- 项目时间跟踪
- 自动化时间记录操作
工具列表
- List Timeslips: 列出时间记录，支持日期范围、用户、任务、项目等筛选条件。
- Create Timeslip: 创建新的时间记录，包括任务、用户、项目、日期、小时数和注释等信息。
- Timer Controls: 启动和停止计时器。
常见问题解答
- 如何获取 OAuth 令牌？ 需要通过 FreeAgent 开发者仪表板获取 OAuth 凭证。
- 如何配置 Docker 环境？ 需要创建
.env文件并设置 FreeAgent 凭证。 - 如何调试？ 可以使用
npm run watch或docker build -t freeagent-mcp .进行开发和调试。
使用教程
使用依赖
- Node.js 18+（直接使用 Node.js 时）
- Docker 和 Docker Compose（容器化使用时）
- FreeAgent 账户及 API 访问权限
- 从 FreeAgent Developer Dashboard 获取的 OAuth 凭证
安装教程
选项 1: 直接使用 Node.js 安装
- 克隆仓库：
git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp
- 安装依赖：
npm install
- 获取 OAuth 令牌：
export FREEAGENT_CLIENT_ID="your_client_id"
export FREEAGENT_CLIENT_SECRET="your_client_secret"
node scripts/get-oauth-tokens.js
选项 2: Docker 安装
- 克隆仓库：
git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp
- 创建环境文件：
cp .env.example .env
# 编辑 .env 文件设置 FreeAgent 凭证
- 构建 Docker 镜像：
docker build -t freeagent-mcp .
调试方式
Node.js 开发
npm run build
npm run watch
npm test
Docker 开发
docker build -t freeagent-mcp .