Crewhu

Crewhu MCP 服务

适用于 Crewhu 的模型上下文协议（MCP）服务——Crewhu 是一个客户反馈、员工参与和游戏化平台。它支持 AI 助手管理调查、徽章、奖品和用户参与数据。

这是一个模型上下文协议（MCP）服务，可将 Claude（或任何兼容 MCP 的 AI）连接到你的 Crewhu 环境。

属于 MSP Claude Plugins 生态系统——一套不断扩展的 MSP 技术栈 AI 集成工具。由 MSP 为 MSP 打造。

安装

npm install @wyre-ai/crewhu-mcp

配置

复制 .env.example，并设置以下变量。在该文件中将 CONDUIT_S2S_SECRET 留空。

变量	必填	说明
CREWHU_API_TOKEN	用于 stdio 和 AUTH_MODE=env	Crewhu API 令牌。在网关模式下不会读取。
MCP_TRANSPORT	否	stdio（默认）或 http
AUTH_MODE	否	gateway（Docker 镜像和 Compose 的默认值）或 env。网关模式要求每个 /mcp 请求都携带 X-Crewhu-Api-Token，且绝不会回退到 CREWHU_API_TOKEN。env 仅在 S2S 身份验证成功后使用该变量。
CONDUIT_S2S_SECRET	HTTP 必填	服务间 HMAC 密钥。如果该值为空或为已知占位值（如 changeme、replace-with-a-real-secret 等），HTTP 服务会记录错误并以非零状态码退出。未设置该值时，Compose 不会启动。使用 openssl rand -hex 32 生成。切勿提交真实值。该值不会被记录。
MCP_ALLOW_INSECURE_DEV	否	仅在本地开发时，将其精确设置为 1，即可在没有 CONDUIT_S2S_SECRET 的情况下启动 HTTP。进程会记录警告，且不会强制校验 X-Gateway-S2S。即使 MCP_HTTP_HOST 设置为范围更广的地址，监听地址也会强制设为 127.0.0.1。仍会拒绝占位密钥。
MCP_HTTP_HOST	否	MCP_TRANSPORT=http 时的绑定地址。默认为 127.0.0.1。设置了 CONDUIT_S2S_SECRET 时，该值才会生效。容器镜像将其设为 0.0.0.0。
MCP_HTTP_PORT	否	HTTP 端口。默认为 8080。

/health 无需身份验证，也不要求 X-Gateway-S2S。stdio 传输不使用 CONDUIT_S2S_SECRET。

HTTP 身份验证

使用 MCP_TRANSPORT=http 且设置了真实的 CONDUIT_S2S_SECRET 时，每个 /mcp 请求都必须携带 X-Gateway-S2S。缺少该标头或标头无效时，会在读取任何供应商凭据之前返回 401。

该标头是一个 HMAC 证明：

X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256>

v1 是以 CONDUIT_S2S_SECRET 为密钥，对 ASCII 字符串 t=<unix seconds>（相同的 t= 前缀和值）计算得到的十六进制编码 HMAC-SHA256。时间戳与服务器时钟的偏差必须在 300 秒以内。

t=$(date +%s)
sig=$(printf 't=%s' "$t" | openssl dgst -sha256 -hmac "$CONDUIT_S2S_SECRET" -hex | awk '{print $NF}')
curl -sS "http://127.0.0.1:8080/mcp" \
  -H "X-Gateway-S2S: t=${t},v1=${sig}" \
  -H "X-Crewhu-Api-Token: $CREWHU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

在 AUTH_MODE=gateway 模式下，/mcp 还要求 X-Crewhu-Api-Token。缺少该标头或其内容为空白时，会返回 401，且不会回退到 CREWHU_API_TOKEN。

用法

在 Claude Desktop 中运行

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json：

{
  "mcpServers": {
    "crewhu-mcp": {
      "command": "npx",
      "args": ["@wyre-ai/crewhu-mcp"],
      "env": {
        "CREWHU_API_TOKEN": "your-crewhu-api-token"
      }
    }
  }
}

在 Claude Code（CLI）中运行

claude mcp add crewhu-mcp \
  -e CREWHU_API_TOKEN=your-value \
  -- npx -y @wyre-ai/crewhu-mcp

Docker

该镜像在容器内的 0.0.0.0（MCP_HTTP_HOST）上监听，且默认使用 AUTH_MODE=gateway。请在回环地址上发布端口，并传入真实的 S2S 密钥。在网关模式下，Crewhu 令牌会随每个请求通过 X-Crewhu-Api-Token 传入，而不会从环境中读取。如果 CONDUIT_S2S_SECRET 为空或为已知占位值，启动时会退出。

docker build -t crewhu-mcp .
docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -p 127.0.0.1:8080:8080 \
  crewhu-mcp

如果未设置 CONDUIT_S2S_SECRET，Compose 会拒绝启动；它默认将 AUTH_MODE 设为 gateway，发布 127.0.0.1:8080:8080，且不会设置 CREWHU_API_TOKEN：

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose up

单租户 HTTP（AUTH_MODE=env）仍要求设置 S2S 密钥，之后才会使用 CREWHU_API_TOKEN：

docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e AUTH_MODE=env \
  -e CREWHU_API_TOKEN=your-value \
  -p 127.0.0.1:8080:8080 \
  crewhu-mcp

不带密钥的本地 HTTP 仅供开发使用。它只绑定到 127.0.0.1，并会记录警告。非回环地址的 MCP_HTTP_HOST 会被忽略：

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

可用领域

徽章

管理员工徽章并颁发徽章

奖品

管理奖品目录和兑换

调查问卷

创建和管理客户满意度调查问卷

用户

用户管理和参与度数据

开发

# Clone the repository
git clone https://github.com/WYRE-AI/crewhu-mcp.git
cd crewhu-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

贡献

欢迎贡献！如有 CONTRIBUTING.md，请参阅该文件；也可以提交问题来讨论变更。

许可证

本项目根据 Apache License, Version 2.0 许可。详情请参阅 LICENSE。