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

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 で追加する場合

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) に以下を追加してください:

{
  "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"
      }
    }
  }
}

動作確認

claude mcp list

一覧に lychee-redmine が表示されれば設定完了です。Claude Code からプロジェクト・チケット・スケジュール・ユーザー管理のツールが利用可能になります。

Development

# 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