🚀 丰收时间追踪 MCP 服务器

这是一个基于 TypeScript 的 MCP（模型上下文协议）服务器，专为丰收时间追踪应用程序打造，可让 LLM 客户端与丰收账户进行交互。

🚀 快速开始

先决条件

• Bun 运行时
• 带有 API 访问权限的丰收账户
• 从丰收获取的个人访问令牌
• 账户 ID（来自丰收）

更多细节请参考丰收 API 文档中的个人访问令牌创建说明。

✨ 主要特性

此服务器提供了一系列工具，可用于获取公司、客户、项目、用户等信息，还能进行时间记录的搜索、创建等操作。

📦 安装指南

在 Claude Desktop 中配置

在 settings.json 文件中添加以下内容：

{
  "mcpServers": {
    "Harvest": {
      "command": "npx",
      "args": [
        "@harvesttime/tracing-mcp-server",
        "--accountId",
        "<丰收账户 ID>",
        "--token",
        "<丰收个人访问令牌>"
      ],
      "env": {}
    }
  }
}

在 Visual Studio Code 中配置

在 launch.json 文件中添加以下内容：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "启动丰收时间追踪 MCP 服务器",
      "type": "node",
      "request": "launch",
      "program": "$npmBin/file:@harvesttime/tracing-mcp-server",
      "args": [
        "--accountId",
        "<丰收账户 ID>",
        "--token",
        "<丰收个人访问令牌>"
      ]
    }
  ]
}

在 VS Code 中启动

1. 打开终端。
2. 运行以下命令：

   npm install --global @harvesttime/tracing-mcp-server
   

3. 启动配置文件中的 "启动丰收时间追踪 MCP 服务器" 配置。

在命令行中使用

直接运行以下命令：

@harvesttime/tracing-mcp-server --accountId <丰收账户 ID> --token <丰收个人访问令牌>

💻 使用示例

可用工具

📚 详细文档

开发

1. 克隆仓库。
2. 安装依赖：

   npm install
   

3. 启动开发服务器：

   npm run dev
   

4. 测试：

   npm test
   

提交代码

1. 创建功能分支：

   git checkout -b feature/<功能名称>
   

2. 提交更改：

   git add .
   git commit -m "提交信息"
   

3. 推送到远程仓库并创建拉取请求：

   git push origin feature/<功能名称>
   

维护

更新依赖

1. 更新 package.json 中的依赖版本。
2. 保存更改。
3. 安装更新的依赖：

   npm install
   

打包

1. 运行打包命令：

   npm run build
   

贡献指南

欢迎贡献！请遵循以下步骤：

1. 分叉仓库。
2. 提交您的更改。
3. 创建拉取请求。

确保代码符合 代码规范 并通过所有测试。