# Jira MCP Server
MCP сервер для работы с Jira API. Позволяет получать информацию о затреканном времени за текущую неделю.
## Установка
```bash
npm install
```
## Конфигурация
Сервер использует переменные окружения для авторизации в Jira. Создайте файл `.env` в корне проекта или экспортируйте переменные в системе:
```bash
export JIRA_USER=your-email@company.com
export JIRA_PASSWORD=your-password-or-api-token
export JIRA_URL=https://your-domain.atlassian.net
```
**Важно:**
- Для Jira Cloud рекомендуется использовать API-токен вместо пароля
- API-токен можно получить в настройках аккаунта Atlassian: Settings → Security → API Tokens
- Для Jira Server можно использовать обычный пароль пользователя
### Добавление переменных в конфигурацию MCP сервера
Если вы используете MCP сервер через IDE с LLM, переменные окружения можно настроить несколькими способами:
#### Способ 1: Через файл .env (рекомендуется)
Создайте файл `.env` в корне проекта:
```
JIRA_USER=your-email@company.com
JIRA_PASSWORD=your-api-token
JIRA_URL=https://your-domain.atlassian.net
```
Затем запустите сервер с загрузкой переменных:
```bash
# Если используете dotenv
npm install dotenv
# И добавьте в начало index.ts: import 'dotenv/config';
```
#### Способ 2: Через переменные окружения системы
```bash
export JIRA_USER=your-email@company.com
export JIRA_PASSWORD=your-api-token
export JIRA_URL=https://your-domain.atlassian.net
npm run dev
```
#### Способ 3: Через конфигурацию IDE
В настройках вашей IDE (например, Cursor) найдите раздел конфигурации MCP серверов и добавьте переменные окружения:
```json
{
"mcpServers": {
"jira-assistant": {
"command": "node",
"args": ["path/to/index.js"],
"env": {
"JIRA_USER": "your-email@company.com",
"JIRA_PASSWORD": "your-api-token",
"JIRA_URL": "https://your-domain.atlassian.net"
}
}
}
}
```
## Запуск
### Локальный запуск в фоне
```bash
# Разработка
npm run dev
# Или в фоне
nohup npm run dev > mcp-server.log 2>&1 &
```
### Запуск на определенном порту
MCP сервер по умолчанию использует stdio транспорт. Если вам нужен HTTP сервер, можно использовать дополнительную обертку.
## Доступные инструменты (Tools)
### Get weekly time tracking
Получает затреканное время за текущую неделю (с понедельника по воскресенье).
**Параметры:** нет
**Возвращает:**
- Общее время за неделю
- Детали по каждой задаче с указанием времени и даты
- Период недели (даты начала и конца)
## Авторизация
Сервер использует Basic Authentication для работы с Jira API:
```
Authorization: Basic base64(username:password)
```
Кодирование происходит автоматически на основе переменных окружения `JIRA_USER` и `JIRA_PASSWORD`.
## Безопасность
⚠️ **Важно:** Не коммитьте файл `.env` в репозиторий. Добавьте его в `.gitignore`:
```
.env
.env.local
```
## Пример использования
После запуска сервера и подключения его к IDE с LLM, вы можете запросить:
```
Получи мое затреканное время за эту неделю
```
Сервер вернет информацию о всех worklog записях за текущую неделю.
