🔴 Redmine MCP Server
MCP Server kết nối Claude Code với Redmine — check issues và log time hàng ngày lúc 17h.
📦 Cài đặt
git clone <your-repo>
cd redmine-mcp
npm install
npm run build
⚙️ Cấu hình
1. Lấy API Key từ Redmine
Vào My account → API access key (góc phải trên) → Copy key.
2. Tạo file .env
cp .env.example .env
Sửa .env:
REDMINE_URL=https://your-redmine.example.com
REDMINE_API_KEY=your_api_key_here
3. Thêm vào Claude Code
Mở file ~/.claude.json (tạo nếu chưa có) và thêm:
{
"mcpServers": {
"redmine": {
"command": "node",
"args": ["/absolute/path/to/redmine-mcp/dist/index.js"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your_api_key_here"
}
}
}
}
Lưu ý: Thay
/absolute/path/to/redmine-mcpbằng đường dẫn thực tế trên máy bạn.
Hoặc dùng lệnh CLI:
claude mcp add redmine -- node /absolute/path/to/redmine-mcp/dist/index.js
🛠️ Các tools có sẵn
| Tool | Mô tả |
|---|---|
whoami |
Kiểm tra kết nối & user hiện tại |
check_my_issues |
Xem issues được assign cho bạn |
get_issue_detail |
Xem chi tiết issue + comments |
create_issue |
Tạo issue mới |
update_issue |
Cập nhật status, % done, comment |
log_time |
⏱️ Log time vào issue |
get_today_time_log |
Xem time đã log hôm nay |
get_time_activities |
Danh sách loại activity |
get_projects |
Danh sách projects |
📅 Workflow log time 17h hàng ngày
Mỗi 17h, nói với Claude:
"Log time cho hôm nay đi"
Claude sẽ tự động:
- Gọi
check_my_issues— xem bạn đang làm issues gì - Gọi
get_today_time_log— kiểm tra đã log chưa - Hỏi bạn làm gì, bao lâu
- Gọi
log_time— ghi vào Redmine
🧪 Test kết nối
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}' \
| REDMINE_URL=https://your.redmine.com REDMINE_API_KEY=xxx node dist/index.js
