关键词

时间追踪AI助手集成VAR系统项目管理自然语言交互

项目简介 VAR MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在将您的AI助手（如Claude Desktop, ChatGPT等）与VAR时间追踪系统无缝集成。它允许您通过自然语言指令来执行时间追踪、项目管理和数据查询等操作，极大地提升了工作效率。

主要功能点

  • 安全认证管理：通过MCP协议安全配置、验证和刷新VAR API令牌，确保与VAR系统的安全连接。
  • 项目与标签数据访问：提供API接口，允许AI助手查询、搜索和筛选VAR系统中的项目和标签数据。
  • 时间条目管理：支持创建、更新、删除和列出时间条目，包括日期范围筛选、项目过滤、标签关联和计费状态管理。
  • 全面的系统文档：提供自描述的MCP服务器、工具、资源和Prompt文档，帮助用户和客户端理解系统能力和用法。
  • 会话与上下文管理：以标准化的方式向LLM客户端提供会话上下文信息。

安装步骤

  1. 下载可执行文件：从 'var-mcp' 仓库的 Release 页面下载适用于您操作系统的二进制文件（例如，Linux用户下载 'var-mcp-linux'，macOS用户下载 'var-mcp-macos'，Windows用户下载 'var-mcp-windows.exe'）。

  2. （仅限Linux/macOS）设为可执行：在终端中，导航到下载的二进制文件所在目录，然后运行以下命令：

    chmod +x /path/to/var-mcp-linux
# 或对于 macOS:
chmod +x /path/to/var-mcp-macos

    请将 '/path/to/' 替换为实际的文件路径。

  3. 配置您的AI助手： 您需要根据您的AI助手类型，编辑相应的MCP配置文件，添加VAR MCP服务器的启动信息。以下是常见的AI助手配置示例，请根据您的实际情况进行调整。请将 '/path/to/var-mcp-linux' 替换为您实际下载的二进制文件路径，并根据您的操作系统选择正确的命令。

    • 对于 Claude Desktop： 找到您的Claude配置文件（macOS通常在 '~/Library/Application Support/Claude/claude_desktop_config.json'；Windows在 '%APPDATA%/Claude/claude_desktop_config.json'；Linux在 '~/.config/Claude/claude_desktop_config.json'），然后添加以下JSON片段：

      {
  "mcpServers": {
    "var": { // 自定义服务器名称，AI助手将用此名称识别
      "command": "/path/to/var-mcp-linux", // VAR MCP服务器二进制文件的完整路径
      "args": ["start"] // 启动VAR MCP服务器所需的命令参数
    }
  }
}

      如果您使用的是Windows系统，'command' 的值应为 '"C:\path\to\var-mcp-windows.exe"'。 配置完成后，请重启Claude Desktop。

    • 对于 ChatGPT/OpenAI 或其他支持MCP的AI助手： 编辑您的MCP配置文件，添加类似上述Claude Desktop的 'mcpServers' 配置。

    • 对于 VSCode 扩展 (如 Cline)： 在MCP服务器设置中，添加类似以下JSON对象：

      {
  "name": "VAR", // 自定义服务器名称
  "command": "/path/to/var-mcp-linux", // VAR MCP服务器二进制文件的完整路径
  "args": ["start"] // 启动VAR MCP服务器所需的命令参数
}

    • 对于 Continue.dev： 编辑 '~/.continue/config.json' 文件，在 'mcpServers' 数组中添加以下JSON对象：

      {
  "name": "var", // 自定义服务器名称
  "command": "/path/to/var-mcp-linux", // VAR MCP服务器二进制文件的完整路径
  "args": ["start"] // 启动VAR MCP服务器所需的命令参数
}

  4. 设置API令牌：在您的AI助手中，说出或输入以下指令。AI助手会提示您提供VAR API令牌。请按照提示输入您的令牌，系统将对其进行加密并安全存储。 '"Set up my VAR API token"'

基本使用方法 完成安装和配置后，您可以直接与AI助手进行自然语言对话，以管理VAR时间追踪系统。AI助手将通过VAR MCP服务器理解您的请求并执行相应的操作。

  • 记录时间： '"Log 2 hours on project ABC for today"' '"Create a time entry for 90 minutes on bug fixes"'
  • 查询时间条目： '"Show my time entries from this week"' '"List all my time entries for yesterday"'
  • 列出项目： '"List all my projects"' '"Search for projects related to 'mobile app'"'
  • 查询认证状态： '"Check my VAR authentication status"'

关键词 时间追踪, AI助手集成, VAR系统, 项目管理, 自然语言交互

信息

分类

生产力应用

访问项目