Rize Io MCP Server

Rize MCP服务器

MCP服务器 Rize.io 它将Rize GraphQL数据连接到Claude Code。

本项目旨在：

• 希望在Claude工作流中使用Rize数据的开发人员
• 需要透明、可审计集成的团队
• 更喜欢自托管/本地stdio MCP服务器的用户

特性

• get_current_user -获取经过身份验证的用户配置文件
• get_projects -列出支持分页的项目
• get_time_entries -获取时间条目（模式感知回退： sessions 然后 taskTimeEntries)
• create_time_entry -使用模式兼容的变异回退创建手动时间条目

需求

• Python 3.10+
• 紫外线 （推荐）
• Rize Pro计划API密钥(Rize > Settings > API)
• Claude Code CLI已安装并通过身份验证

快速启动

1. 克隆并进入仓库

git clone https://github.com//rize-io-mcp-server.git
cd rize-io-mcp-server

1. 创建本地开发环境文件

cp .env.example .env

1. 编辑 .env 并设置您的密钥

RIZE_API_KEY=your-rize-api-key

1. 安装依赖项

uv sync

连接到克劳德代码（stdio）

对于Claude管理的MCP，更喜欢在MCP中传递API密钥 env 块。这比依赖本地仓库更可靠 .env 重新启动或重新打开Claude后的文件。

注册服务器：

claude mcp add-json rize-tracker '{"type":"stdio","command":"uv","args":["run","--directory","/absolute/path/to/rize-io-mcp-server","python","-m","rize_mcp.server"],"env":{"RIZE_API_KEY":"your-rize-api-key"}}'

地方发展的替代方案：

• 继续使用 .env 在repo根目录中手动运行命令时 uv run ....
• 服务器也会加载 ./.env 从存储库根目录开始，使本地CLI使用情况可预测。

列出服务器：

claude mcp list

在Claude Code中，运行：

/mcp

用法示例

• get_current_user
• get_projects(limit=50)
• get_time_entries(from_date="2026-03-06", to_date="2026-03-06")
• create_time_entry(project_id="...", description="Code review", duration_minutes=30)

配置

环境变量：

• RIZE_API_KEY （必填）
• RIZE_ENDPOINT （可选，默认值： https://api.rize.io/api/v1/graphql)
• RIZE_HTTP_TIMEOUT_SECONDS （可选，默认值： 30)

故障排除

空结果 get_time_entries

• 此服务器更喜欢 sessions(startTime, endTime) 并回落到 taskTimeEntries.
• 验证日期范围和时区期望值（仅日期值使用完整的UTC日边界）。

GraphQL架构不匹配错误

• Rize模式可能因帐户/功能而异。
• 捕获工具输出(attempts + schema_variant)并打开一个问题。

身份验证错误

• 确认API密钥在Rize中处于活动状态。
• 如果克劳德启动MCP，请确认 rize-tracker 条目包括 RIZE_API_KEY 在其中 env 块。
• 如果手动运行服务器，请确认 .env 存在于repo根目录中 RIZE_API_KEY 已设置。
• 更改env值后重新启动Claude。

MCP显示 failed 重新开放克劳德之后

• 更喜欢MCP env 上面显示的配置，而不是仅依赖于 .env.
• 重新运行 claude mcp get rize-tracker 或检查 ~/.claude.json 并验证 env.RIZE_API_KEY 价值存在。
• 如果你仍然喜欢 .env，确认该文件仍然存在于存储库根目录中，并且包含有效密钥。

安全

• .env 被git忽略，永远不应该提交。
• 不要承诺 ~/.claude.json 或其他本地MCP配置文件。
• 如果关键点已暴露，请立即在Rize设置中旋转它。
• 不要将真实的API密钥存储在公开共享的README示例或CLI命令历史记录中。

本地开发

运行测试：

uv run pytest

运行导入烟雾测试：

RIZE_API_KEY=dummy uv run python -c "import rize_mcp.server; print('ok')"

发布检查表

• \[\]跟踪的文件中没有秘密
• \[\]测试通过
• \[\]README命令在新克隆中工作
• \[\]Claude MCP注册命令使用占位符，而不是真正的密钥

许可证

MIT。看 LICENSE.