Timing MCP Server

Timing MCP 服务

用于 Timing 应用功能的模型上下文协议（MCP）服务。 此服务允许 AI 助手与 Timing 的功能交互，帮助用户更高效地管理时间记录和任务。

警告

此代码库与 Timing 无关。这是一个独立项目，旨在增强 Timing 应用的功能。

前提条件

开始之前，请确保已安装以下内容：

• Node.js（建议使用 X.X.X 或更高版本）
• npm（通常随 Node.js 一起安装）
• Timing 账户（用于 API 访问）

安装

1. 克隆代码库：

   git clone https://github.com/your-username/timing-mcp-server.git
   cd timing-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 运行构建

   npm run build
   

配置

复制以下 JSON，并填入相应的 {{PATH}} 值：

{
  "mcpServer": {
    "timing": {
      "command": "node",
      "args": ["{{PATH}}/dist/index.js"],
      "env": {
        "TIMING_API_KEY": "{{YOUR_TIMING_API_KEY}}"
      }
    }
  }
}

你可以从此处获取 Timing API 密钥。

对于 Claude，请将其保存为 Claude Desktop 配置目录中的 claude_desktop_config.json。

~/Library/Application Support/Claude/claude_desktop_config.json

对于 Cursor，请将其保存为以下 Cursor 配置目录中的 mcp.json：

~/.cursor/mcp.json

可用工具

工具名称	描述
timing_list_projects	列出 Timing 中的项目
timing_project	获取项目详情
timing_create_project	创建新项目
timing_update_project	更新现有项目
timing_start_time_entry	开始新的时间记录
timing_stop_time_entry	停止当前时间记录
timing_list_time_entries	列出时间记录
timing_create_time_entry	创建新的时间记录
timing_time_entry	获取时间记录详情
timing_update_time_entry	更新现有时间记录
timing_generate_report	根据时间记录和应用使用情况生成报告

贡献

欢迎贡献！如果你想参与贡献，请按照以下步骤操作：

1. Fork 此代码库。
2. 创建新分支（git checkout -b feature/your-feature-name）。
3. 进行更改。
4. 提交更改（git commit -m 'Add some feature'）。
5. 推送到分支（git push origin feature/your-feature-name）。
6. 创建拉取请求。

请确保根据需要更新测试。

许可证

此项目采用 MIT License 许可。