MOCO agency and project management platform

Name: MOCO agency and project management platform
Author: niondigital

本地服务

github.com/niondigital开发工具664 周前更新

代码仓库

关于 MOCO agency and project management platform

MOCO MCP Server 为员工提供只读的 MOCO 数据访问，涵盖工时、项目、假期和出勤。其工具和提示词可利用 MOCO 账户数据生成报告并辅助规划。

主要功能

01读取工时与活动记录
02列出项目及项目任务
03查看假期和病假
04按日期范围汇总出勤
05用于报告和规划的提示词
06只读 API 访问

适用场景

01生成每周工时报告
02结合公共假期规划休假
03查看项目工时与活动
04检查工时合规情况

MCP 相关

它连接 MOCO API，并向 MCP 客户端提供七种只读工具和八个提示词。配置需要 MOCO API 密钥和子域名。

#moco #agency #time-tracking #presence-monitoring

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": [
        "-y",
        "@niondigital/moco-mcp"
      ],
      "env": {
        "MOCO_API_KEY": "<MOCO_API_KEY>",
        "MOCO_SUBDOMAIN": "<MOCO_SUBDOMAIN>"
      }
    }
  }
}

启动命令npx -y @niondigital/moco-mcp

需要配置的环境变量

MOCO_API_KEY密钥

MOCO_SUBDOMAIN

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@niondigital/moco-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
startDate	string	是	开始日期，采用 ISO 8601 格式（YYYY-MM-DD）
endDate	string	是	结束日期，采用 ISO 8601 格式（YYYY-MM-DD）
projectId	number	否	可选项目 ID，用于筛选特定项目的活动

详细介绍

📊 MOCO MCP 服务

一个模型上下文协议（MCP）服务，为员工提供 MOCO API 的只读访问权限，可用于时间跟踪、项目管理、假期跟踪和出勤监控。

⚡ 快速开始

npx -y @niondigital/moco-mcp

就是这样！服务将启动，并准备好连接到你的 MCP 客户端。

🚀 安装

前置条件

Node.js ≥ 18.0.0
拥有 API 访问权限的 MOCO 账户
MOCO API 密钥和子域名

MCP 客户端集成

Claude Desktop

将以下内容添加到你的 Claude Desktop claude_desktop_config.json 文件中：

MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Cursor

将以下内容添加到 Cursor 设置中：

MacOS： ~/Library/Application Support/Cursor/User/settings.json
Windows： %APPDATA%\Cursor\User\settings.json
Linux： ~/.config/Cursor/User/settings.json

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Windsurf

将以下内容添加到 Windsurf MCP 配置中：

{
   "mcpServers": {
      "moco": {
         "command": "npx",
         "args": ["-y", "@niondigital/moco-mcp"],
         "env": {
            "MOCO_API_KEY": "your-moco-api-key",
            "MOCO_SUBDOMAIN": "your-subdomain"
         }
      }
   }
}

Claude Code (CLI)

将 MCP 服务添加到 Claude Code：

claude mcp add -e MOCO_API_KEY="your-moco-api-key" -e MOCO_SUBDOMAIN="your-subdomain" moco -- npx -y @niondigital/moco-mcp

Gemini CLI

配置支持 MCP 的 Gemini CLI：

{
   "mcpServers": {
      "moco": {
         "command": "npx",
         "args": ["-y", "@niondigital/moco-mcp"],
         "env": {
            "MOCO_API_KEY": "your-moco-api-key",
            "MOCO_SUBDOMAIN": "your-subdomain"
         }
      }
   }
}

Kiro

前往 Kiro > MCP Servers
点击 + Add 添加新的 MCP 服务
粘贴以下配置：

{
  "mcpServers": {
    "moco": {
    "command": "npx",
    "args": [
      "-y",
      "@niondigital/moco-mcp"
    ],
    "env": {
       "MOCO_API_KEY": "your-moco-api-key",
       "MOCO_SUBDOMAIN": "your-subdomain"
    },
    "disabled": false,
    "autoApprove": []
    }
  }
}

点击 Save 应用更改

LM Studio

前往 Program（右侧）> Install > Edit mcp.json
粘贴以下配置：

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
       "env": {
          "MOCO_API_KEY": "your-moco-api-key",
          "MOCO_SUBDOMAIN": "your-subdomain"
       }
    }
  }
}

点击 Save 应用更改
在右侧（Program 下方）切换 MCP 服务的开关，或点击聊天框底部的插头图标

🔑 MOCO API 设置

获取 API 凭据

登录你的 MOCO 账户
前往 API 设置：
- 前往 Profile → Integrations
- 或访问：https://niondigital.mocoapp.com/profile/integrations
复制列出的 API 密钥
记下你的子域名：
- 从你的 MOCO URL 中获取：https://yourcompany.mocoapp.com
- 你的子域名为：yourcompany

环境变量

你可以通过以下几种方式设置环境变量：

选项 1：系统环境变量

export MOCO_API_KEY="your-moco-api-key"
export MOCO_SUBDOMAIN="your-subdomain"

选项 2：.env 文件（用于本地开发）

MOCO_API_KEY=your-moco-api-key
MOCO_SUBDOMAIN=your-subdomain

选项 3：MCP 客户端配置（推荐） 如上所示，在 MCP 客户端配置中使用 env 部分。

🛠️ 可用工具

工具	描述	参数
`get_activities`	获取指定日期范围内的活动，包含汇总，并可选择按项目筛选	`startDate`、`endDate`（ISO 8601）、`projectId`（可选）
`get_user_projects`	列出所有已分配的项目，或按查询条件搜索	`query`（可选）
`get_user_project_tasks`	获取指定已分配项目的所有任务	`projectId`
`get_user_holidays`	获取某一年的假期概览及计算结果	`year`
`get_user_presences`	获取指定日期范围内的出勤数据及每日汇总	`startDate`、`endDate`（ISO 8601）
`get_user_sick_days`	获取某一年的病假概览及计算结果	`year`
`get_public_holidays`	获取某一年的公共假期及工作日计算结果	`year`

🎯 可用提示词

MoCo MCP 服务提供 8 个智能提示词，可协调多个工具以提供全面的洞察：

提示词	描述	关键参数
`weekly_time_report`	生成详细的每周工时跟踪报告，并按项目分类	`week_start`、`include_billable_analysis`
`vacation_planning_assistant`	分析可用假期天数和节假日，协助规划休假	`planned_start_date`、`planned_end_date`
`personal_productivity_insights`	分析工作习惯并提供效率建议	`analysis_period`、`focus_area`
`monthly_business_review`	创建包含趋势和指标的综合业务报告	`month`、`year`、`include_comparisons`
`smart_work_life_balance_advisor`	评估工作与生活的平衡状况，并提供个性化建议	`analysis_weeks`、`target_hours_per_week`
`project_time_analysis`	详细分析项目工时并提供效率指标	`project_ids`、`time_period`
`team_capacity_overview`	结合缺勤和资源分析进行团队产能规划	`planning_horizon`、`include_holidays`
`work_hours_compliance_check`	检查是否符合工作时间规定	`check_period`、`max_weekly_hours`、`max_daily_hours`

提示词示例

每周工时报告：

{
  "name": "weekly_time_report",
  "arguments": {
    "week_start": "2024-01-15",
    "include_billable_analysis": true
  }
}

休假规划：

{
  "name": "vacation_planning_assistant",
  "arguments": {
    "planned_start_date": "2024-07-15",
    "planned_end_date": "2024-07-29"
  }
}

工作与生活平衡分析：

{
  "name": "smart_work_life_balance_advisor",
  "arguments": {
    "analysis_weeks": 6,
    "target_hours_per_week": 40
  }
}

合规性检查：

{
  "name": "work_hours_compliance_check",
  "arguments": {
    "check_period": "last_month",
    "max_weekly_hours": 48,
    "max_daily_hours": 10
  }
}

📝 工具示例

获取活动记录

筛选日期范围内的所有活动记录：

{
  "name": "get_activities",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31"
  }
}

筛选特定项目的活动记录：

{
  "name": "get_activities",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "projectId": 123456
  }
}

示例输出：

Activities from 2024-01-01 to 2024-01-31:

2024-01-15:
  Project 123 (Website Redesign):
    Task 456 (Frontend Development): 4.5h (4:30)
    Task 789 (Backend API): 3.25h (3:15)
    Project total: 7.75h (7:45)
  Daily total: 7.75h (7:45)

Grand total: 7.75h (7:45)

获取用户项目

列出所有已分配的项目：

{
  "name": "get_user_projects",
  "arguments": {}
}

搜索项目：

{
  "name": "get_user_projects",
  "arguments": {
    "query": "website"
  }
}

获取用户项目任务

{
  "name": "get_user_project_tasks",
  "arguments": {
    "projectId": 123456
  }
}

获取用户假期

{
  "name": "get_user_holidays",
  "arguments": {
    "year": 2024
  }
}

示例输出：

Holiday overview for 2024:

Taken holiday days:
- 2024-03-15: 1.0 day
- 2024-04-22: 0.5 day
- 2024-07-08: 1.0 day

Summary:
- Taken vacation: 2.5 days
- Annual entitlement: 25 days
- Utilization: 10% (2.5/25)
- Remaining vacation: 22.5 days

获取用户出勤记录

{
  "name": "get_user_presences",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-07"
  }
}

示例输出：

Presences from 2024-01-01 to 2024-01-07:

Daily presences:
- 2024-01-01: 8.25h (8:15)
- 2024-01-02: 7.5h (7:30)
- 2024-01-03: 8.0h (8:00)

Grand total: 23.75h (23:45)

Statistics:
- Working days: 3
- Average per day: 7.92h (7:55)

获取用户病假记录

{
  "name": "get_user_sick_days",
  "arguments": {
    "year": 2024
  }
}

获取公共假日

{
  "name": "get_public_holidays",
  "arguments": {
    "year": 2024
  }
}

示例输出：

Public holidays for 2024:

Holiday dates:
- 2024-01-01: New Year's Day
- 2024-04-01: Good Friday
- 2024-04-03: Easter Monday
- 2024-05-01: Labor Day
- 2024-05-09: Ascension Day
- 2024-05-20: Whit Monday
- 2024-10-03: German Unity Day
- 2024-12-25: Christmas Day
- 2024-12-26: Boxing Day

Summary:
- Total public holidays: 9 days
- Approximate working days: 251 days

🔧 高级配置

本地开发

如果要从源代码运行：

git clone https://github.com/niondigital/moco-mcp.git
cd moco-mcp
npm install
npm run build
npm start

然后配置 MCP 客户端使用本地路径：

{
  "mcpServers": {
    "moco": {
      "command": "node",
      "args": ["/path/to/moco-mcp/dist/index.js"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Docker 支持

FROM node:18-alpine
WORKDIR /app
RUN npm install -g @niondigital/moco-mcp
ENV MOCO_API_KEY=""
ENV MOCO_SUBDOMAIN=""
CMD ["@niondigital/moco-mcp"]

🔍 故障排除

常见问题

❌ 身份验证错误：

API authentication failed. Please check MOCO_API_KEY.

确认 API 密钥正确且具有必要的权限
检查是否已在环境变量中正确设置 API 密钥
确认密钥尚未过期

❌ 子域名错误：

MOCO_SUBDOMAIN should only contain the subdomain name

仅使用子域名部分：company（不要使用 company.mocoapp.com）
从子域名中移除 https:// 和 .mocoapp.com

❌ Node.js 版本错误：

This package requires Node.js >= 18.0.0

将 Node.js 更新到 18 或更高版本
检查版本：node --version

❌ npx 连接问题：

Error: Cannot find module '@niondigital/moco-mcp'

确保已连接互联网
尝试：npx --yes @niondigital/moco-mcp
清除 npx 缓存：npx clear-npx-cache

❌ MCP 客户端未找到工具：

更改配置后重启 MCP 客户端
检查环境变量是否已正确设置
确认 JSON 配置语法正确

调试模式

如需调试，可以运行服务并启用更多日志记录：

NODE_ENV=development npx -y @niondigital/moco-mcp

测试连接

你可以手动测试服务：

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx -y @niondigital/moco-mcp

🌟 功能

✅ 只读访问： 安全集成 API，不会修改数据
🔄 自动分页： 无缝处理大型数据集
📊 智能聚合： 自动按日期、项目和任务汇总
🎯 项目筛选： 按特定项目筛选活动记录
🧩 全面的工具： 提供 7 个专用工具，适用于不同使用场景
🎯 智能提示词： 提供 8 个 AI 驱动的提示词，用于复杂分析并生成洞察
🌐 多客户端支持： 适用于所有主流 MCP 客户端

🤝 参与贡献

Fork 仓库
创建功能分支：git checkout -b feature-name
进行修改并添加测试
运行测试：npm test
提交 Pull Request

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

🆘 支持

MOCO API 问题：MOCO API 文档
MCP 协议：MCP 文档
此软件包：GitHub Issues

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

MOCO agency and project management platform

关于 MOCO agency and project management platform

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

📊 MOCO MCP 服务

⚡ 快速开始

🚀 安装

前置条件

MCP 客户端集成

🔑 MOCO API 设置

获取 API 凭据

环境变量

🛠️ 可用工具

🎯 可用提示词

提示词示例

📝 工具示例

获取活动记录

获取用户项目

获取用户项目任务

获取用户假期

获取用户出勤记录

获取用户病假记录

获取公共假日

🔧 高级配置

🔍 故障排除

常见问题

调试模式

测试连接

🌟 功能

🤝 参与贡献

📄 许可证

🆘 支持

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？