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已安装并通过身份验证
快速启动
- 克隆并进入仓库
git clone https://github.com//rize-io-mcp-server.git
cd rize-io-mcp-server- 创建本地开发环境文件
cp .env.example .env- 编辑
.env并设置您的密钥
RIZE_API_KEY=your-rize-api-key- 安装依赖项
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_userget_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.