AI导哈

项目时间管理API服务

Costlocker-MCP是一个连接AI助手与Costlocker项目管理工具的API服务，支持通过自然语言操作项目、预算、时间表等功能。

  • by jan-sevcik-snadnee
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jan-sevcik-snadnee/costlocker-mcp

使用说明

costclocker mcp

MCP服务器 Costlocker --您的项目管理和时间跟踪工具。将您的AI助手连接到Costlocker，并通过自然语言处理项目、预算、时间表等。

快速启动

1.从Costlocker获取您的API代币

只有帐户 所有者 可以创建API令牌。请参阅 带截图的分步指南.

  1. 登录 Costlocker
  2. 点击您的 名字 在右上角，选择 设置
  3. 去 API 选项卡（或直接转到 new.costlocker.com/settings/api)
  4. 复制您的 个人访问令牌 （点击“复制到剪贴板”或“再生令牌”，如果你还没有一个）

2.配置您的MCP客户端

添加 costlocker 服务器到MCP客户端配置。桌面应用程序示例：

  • macOS配置： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows配置： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "costlocker": {
      "command": "npx",
      "args": ["-y", "costlocker-mcp"],
      "env": {
        "COSTLOCKER_API_TOKEN": "your-api-token"
      }
    }
  }
}

替换 your-api-token 使用步骤1中的令牌。

3.重新启动MCP客户端

就是这样。你的人工智能助理现在可以访问你的Costlocker数据。试着问：

  • “显示所有正在运行的项目”
  • “我这周记录了多少小时？”
  • “项目X的预算状况如何？”

它能做什么？

类别 工具 描述
项目 list_projects, get_project, search_projects 浏览和搜索项目
create_project, update_project 创建或更新项目（确认）
时间表 log_time 记录时间条目（带确认）
get_timesheet, get_monthly_timesheet 查看时间表数据
get_running_entry, get_assignments 检查运行计时器和可用分配
人们 list_people, get_me, get_project_people 查看团队成员和任务
金融 get_project_budget, get_project_billing, get_project_expenses 查看预算、账单和费用
查找 list_clients, list_activities, list_tags, list_groups 浏览参考数据

所有工具名称前面都有前缀 costlocker_ （例如。 costlocker_list_projects).

安全

  • 写入操作 (create_project, update_project, log_time)需要用户确认——人工智能在做出更改之前总是会询问
  • 输入验证 所有写操作（Zod模式）
  • 访问控制 由您的个人API令牌处理-您只能看到Costlocker角色允许的数据
  • 凭证检查 通过启动 /me 端点--无效令牌立即失败
  • 错误清理 -API错误响应被截断以防止敏感数据泄漏

配置

环境变量 必填 说明
COSTLOCKER_API_TOKEN 是 Costlocker API设置中的个人访问令牌
COSTLOCKER_HOST 没有 API主机（默认值： https://rest.costlocker.com)

许可证

麻省理工学院

相关 MCP