# MCP Server for Lychee Redmine
Model Context Protocol (MCP) server for integrating Lychee Redmine project management with AI assistants like Claude.
## Requirements
- Node.js 22.18.0 or higher
- Lychee Redmine instance with API access
## Installation
```bash
npm install
```
## Configuration
Set the following environment variables:
- `LYCHEE_REDMINE_URL`: Your Lychee Redmine instance URL (HTTPS required)
- `LYCHEE_REDMINE_API_KEY`: Your Redmine API key
- `LOG_LEVEL`: (Optional) Log level: DEBUG, INFO, WARN, ERROR (default: INFO)
## Setup for Claude Code
### CLI で追加する場合
```bash
claude mcp add lychee-redmine \
-e LYCHEE_REDMINE_URL=https://your-redmine-instance.example.com \
-e LYCHEE_REDMINE_API_KEY=your-api-key \
-- npx -y github:ssoma-dev/mcp-server-lychee-redmine
```
### 設定ファイルを直接編集する場合
グローバル設定 (`~/.claude/settings.json`) またはプロジェクト設定 (`.claude/settings.json`) に以下を追加してください:
```json
{
"mcpServers": {
"lychee-redmine": {
"command": "npx",
"args": ["-y", "github:ssoma-dev/mcp-server-lychee-redmine"],
"env": {
"LYCHEE_REDMINE_URL": "https://your-redmine-instance.example.com",
"LYCHEE_REDMINE_API_KEY": "your-api-key"
}
}
}
}
```
### 動作確認
```bash
claude mcp list
```
一覧に `lychee-redmine` が表示されれば設定完了です。Claude Code からプロジェクト・チケット・スケジュール・ユーザー管理のツールが利用可能になります。
## Development
```bash
# Run in development mode
npm run dev
# Build
npm run build
# Run tests
npm test
# Run tests with coverage
npm run test:coverage
# Type checking
npm run typecheck
# Lint
npm run lint
# Format code
npm run format
```
## Architecture
This MCP server follows Domain-Driven Design principles with clear separation:
- `/src/server/` - MCP Server Core
- `/src/redmine/` - Redmine Integration
- `/src/config/` - Configuration Management
- `/src/utils/` - Utilities (Logger, Error Handler, Retry Handler)
## License
MIT
