README

Multi-provider MCP server for project management and time tracking. Connects AI assistants (Claude Desktop/Code, Cursor, etc.) to Redmine, Jira Cloud, Monday.com, and Trello with OAuth2.

Supported Providers

MCP Tools

Tools are dynamically exposed based on provider capabilities:

Quick Start

Claude Code Configuration

Create .mcp.json in your project or ~/.claude/.mcp.json:

{
  "mcpServers": {
    "timetracking": {
      "type": "http",
      "url": "https://your-server.com/mcp"
    }
  }
}

Authentication

1. First request → Google Sign-In redirect
2. Choose provider (Redmine/Jira/Monday)
3. Enter credentials (URL + API key)
4. JWT token generated with encrypted credentials

Architecture

flowchart TB
    subgraph Clients
        Claude["Claude Desktop/Code"]
        Cursor
    end

    subgraph MCP["MCP Server"]
        Auth["Google OAuth → JWT"]
        Tools["MCP Tools"]

        subgraph Domain["Domain Models"]
            Project
            Issue["Issue (+ Comments, Attachments)"]
            TimeEntry["TimeEntry (+ Activity)"]
            User
        end

        subgraph Adapters
            RedmineAdapter
            JiraAdapter
            MondayAdapter
        end
    end

    subgraph APIs["External APIs"]
        Redmine
        Jira
        Monday
    end

    Clients -->|HTTP + JWT| Tools
    Tools --> Domain
    Domain --> Adapters
    RedmineAdapter --> Redmine
    JiraAdapter --> Jira
    MondayAdapter --> Monday

Principles

• No database: Credentials embedded in JWT
• Dynamic capabilities: Tools filtered by provider (e.g., Monday doesn't have log_time)

Installation

Docker (Production)

git clone https://github.com/guiziweb/mcp-project-management.git
cd mcp-project-management
cp .env.example .env.local
# Edit .env.local

make deploy

Local (Development)

composer install
cp .env.example .env.local
# Edit .env.local

symfony server:start --port=8080

Configuration

Environment Variables

# Required
APP_URL=https://your-server.com
JWT_SECRET=your-jwt-secret
ENCRYPTION_KEY=base64-encoded-sodium-key
GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=xxx

# Access control (at least one required)
ALLOWED_EMAIL_DOMAINS=company.com
ALLOWED_EMAILS=user@example.com

Google OAuth Setup

1. Google Cloud Console → New project
2. APIs & Services → OAuth consent screen → External
3. Credentials → OAuth 2.0 Client ID → Web application
4. Redirect URI: https://your-server.com/oauth/google-callback

Commands

make dev              # Install dev dependencies
make static-analysis  # PHPStan + CS check + lints
make cs-fix           # Fix code style
make test             # Run tests
make deploy           # Docker rebuild

Bot Token (automation)

# Redmine
php bin/console app:create-bot \
  --provider=redmine \
  --email=bot@company.com \
  --url=https://redmine.company.com \
  --api-key=xxx

# Jira
php bin/console app:create-bot \
  --provider=jira \
  --email=bot@company.com \
  --url=https://company.atlassian.net \
  --api-key=xxx \
  --provider-email=jira-user@company.com

# Monday (no --url needed)
php bin/console app:create-bot \
  --provider=monday \
  --email=bot@company.com \
  --api-key=xxx

Project Structure

src/
├── Domain/
│   ├── Model/          # Issue, Project, TimeEntry, User, etc.
│   ├── Port/           # Interfaces (IssuePort, TimeEntryReadPort, etc.)
│   └── Service/        # Domain services
├── Infrastructure/
│   ├── Adapter/        # AdapterFactory, CurrentUserService
│   ├── Redmine/        # RedmineAdapter, RedmineClient, Normalizers
│   ├── Jira/           # JiraAdapter, JiraClient, Normalizers
│   ├── Monday/         # MondayAdapter, MondayClient, Normalizers
│   ├── Security/       # JWT, OAuth, Encryption
│   └── Web/            # Forms, Components
├── Tools/              # MCP Tools (ListIssuesTool, LogTimeTool, etc.)
└── Controller/         # McpController, OAuthController

License

MIT