mcp-weekly-report/README.md

MCP server for editing Confluence weekly reports with markdown to HTML conversion and synergy collaboration support

# MCP Weekly Report

MCP server for editing Confluence weekly reports with markdown to HTML conversion and synergy collaboration support.

## Features

- Edit specific cells in Confluence weekly report tables
- Automatic markdown to HTML conversion (** to <strong>, * to <em>)
- Support for synergy collaboration content structuring
- Recent pages analysis for report generation
- Clean cell content replacement with proper HTML formatting

## Installation

```bash
npm install -g mcp-weekly-report
```

## Usage

### As MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "weekly-report": {
      "command": "mcp-weekly-report"
    }
  }
}
```

### Environment Variables

Set these environment variables:

```bash
CONFLUENCE_URL=https://your-confluence.atlassian.net/wiki/
CONFLUENCE_USERNAME=your-email@company.com
CONFLUENCE_API_TOKEN=your-api-token
```

## Available Tools

### edit_weekly_report_cell

Edit a specific cell in a Confluence weekly report table.

**Parameters:**
- `page_id`: Confluence page ID
- `week_label`: Week tab name (e.g., "2024년 50주차")
- `team_name`: Team name (e.g., "webOS Platform")
- `column_header`: Column header name (e.g., "시너지 협업 방안", "주요 이슈 및 의사결정 사항")
- `new_content_html`: New content in HTML format (markdown will be auto-converted)

### get_recent_space_pages

Get recent pages from a Confluence space.

**Parameters:**
- `space_key`: Confluence space key
- `days`: Number of days to look back (default: 7)

### summarize_recent_pages_for_report

Summarize recent page changes for weekly report format.

**Parameters:**
- `space_key`: Confluence space key
- `days`: Number of days to look back (default: 7)

## Examples

### Edit Weekly Report Cell

```python
# Edit synergy collaboration cell
edit_weekly_report_cell(
    page_id="123456789",
    week_label="2024년 50주차",
    team_name="webOS Platform",
    column_header="시너지 협업 방안",
    new_content_html="**협업 대상:** IT팀<br/>**협업 내용:** 새로운 서비스 개발"
)
```

### Get Recent Pages

```python
# Get recent pages from space
recent_pages = get_recent_space_pages(
    space_key="WEBOS",
    days=7
)
```

## Markdown to HTML Conversion

The server automatically converts markdown formatting to HTML:

- `**bold text**` → `<strong>bold text</strong>`
- `*italic text*` → `<em>italic text</em>`

## License

MIT