🚀 Linear-MCP-for-Gemini_CLI

Мощный сервер Model Context Protocol (MCP) с открытым исходным кодом, созданный специально для прямого подключения Gemini CLI к вашему рабочему пространству Linear. Управляйте задачами, командами и рабочими процессами с помощью естественного языка прямо из терминала.

🌟 Функции

• 🔍 Поиск и обнаружение: Находите задачи во всем рабочем пространстве прямо из Gemini CLI.

• 📝 Управление задачами: Легко получайте, создавайте и обновляйте задачи (статус, приоритет, исполнитель и т. д.).

• 💬 Совместная работа: Добавляйте комментарии к задачам, не покидая терминал.

• 🏢 Аналитика рабочего пространства: Получайте список команд, пользователей и состояний рабочих процессов, чтобы предоставить Gemini полный контекст.

• ⚡ Интеграция в реальном времени: Построено на базе Model Context Protocol для безопасной связи с низкой задержкой.

📋 Предварительные требования

Перед началом убедитесь, что у вас установлено следующее:

• Node.js: Версия 18.0.0 или выше.

• Gemini CLI: Установлен и настроен на вашем компьютере.

• Аккаунт Linear: С доступом для создания API-ключа.

📖 Полное руководство по интеграции с Gemini CLI

Этот сервер написан на TypeScript. Поскольку Gemini CLI требует стандартный исполняемый файл JavaScript для запуска серверов MCP, нам сначала нужно загрузить и «собрать» проект.

Выполните эти 4 шага, чтобы все подключить.

Шаг 1: Загрузка и сборка сервера

1. Клонируйте репозиторий на свой компьютер:

   git clone https://github.com/tenx-studio/Linear-MCP.git
   cd linear-mcp-open-source

2. Установите необходимые пакеты:

   npm install

3. Скомпилируйте код:

   npm run build

   (Зачем это нужно? Эта команда преобразует код TypeScript в файл dist/index.js, который Gemini CLI будет использовать для связи с Linear).

Шаг 2: Получение API-ключа Linear

1. Перейдите в Settings > API > Personal API keys в вашем рабочем пространстве Linear.

2. Нажмите New API key и дайте ему описательное имя (например, "Gemini CLI").

3. Скопируйте ключ (он понадобится вам на последнем шаге).

Шаг 3: Подключение к Gemini CLI (единственная необходимая настройка)

Теперь мы сообщим Gemini CLI, где найти собранный сервер, и безопасно предоставим ему ваш API-ключ. Это делается путем редактирования файла настроек Gemini CLI.

1. Найдите файл настроек: Откройте файловый менеджер или терминал и найдите папку .gemini в домашней директории пользователя:

   • Windows: %USERPROFILE%\.gemini\settings.json (например, C:\Users\YourName\.gemini\settings.json)

   • Mac/Linux: ~/.gemini/settings.json (Примечание: Если папка .gemini или файл settings.json еще не существуют, просто создайте их).

2. Добавьте конфигурацию: Откройте settings.json в любом текстовом редакторе (например, VS Code, Notepad или TextEdit) и вставьте следующий блок mcp. Если в вашем файле уже есть содержимое, просто добавьте раздел "mcp" внутри основных фигурных скобок {}:

{
  "mcp": {
    "servers": {
      "linear": {
        "command": "node",
        "args": ["/ABSOLUTE/PATH/TO/linear-mcp-open-source/dist/index.js"],
        "env": {
          "LINEAR_API_KEY": "lin_api_your_key_here"
        }
      }
    }
  }
}

⚠️ Важные примечания:

• args: Вы ОБЯЗАНЫ заменить /ABSOLUTE/PATH/TO/... на фактический полный путь на вашем компьютере, куда вы клонировали этот репозиторий. (например, "D:/Projects/linear-mcp-open-source/dist/index.js").

• LINEAR_API_KEY: Замените lin_api_your_key_here на точный API-ключ, который вы скопировали на шаге 2.

Шаг 4: Начните общение!

Закройте и снова откройте терминал, чтобы перезапустить сеанс Gemini CLI. Интеграция теперь активна!

Попробуйте спросить Gemini CLI о чем-то вроде:

"List my Linear teams." "Find the issue about the login bug." "Create a new high priority issue in the Engineering team to update the README."

🤖 Магия автоподключения (как это работает)

Возможно, вы задаетесь вопросом: "Нужно ли мне запускать npm start каждый раз, когда я хочу использовать это? Нужно ли мне вручную настраивать подключение к серверу?"

Нет! Вам не нужно делать ничего лишнего.

Добавление блока конфигурации на шаге 3 — это единственная необходимая настройка. Вот что именно происходит «под капотом»:

1. Запуск без участия пользователя: Поскольку вы добавили конфигурацию в свой settings.json, Gemini CLI изначально выступает в роли хоста.

2. Фоновое выполнение: Каждый раз, когда вы начинаете новый чат в Gemini CLI, он автоматически запускает этот сервер Linear MCP в скрытом фоновом процессе.

3. Безопасное рукопожатие: Gemini CLI считывает "LINEAR_API_KEY" из ваших настроек и безопасно внедряет его непосредственно в сервер.

4. Чистое завершение работы: Когда вы закрываете Gemini CLI, фоновый сервер автоматически завершает работу.

Вы настраиваете это один раз в своих параметрах, а Model Context Protocol автоматически обрабатывает весь жизненный цикл за вас!

🤝 Участие в разработке

Вклад сообщества делает open-source таким удивительным местом для обучения, вдохновения и творчества. Любой ваш вклад очень ценится.

1. Сделайте форк проекта

2. Создайте ветку для вашей функции (git checkout -b feature/AmazingFeature)

3. Зафиксируйте изменения (git commit -m 'Add some AmazingFeature')

4. Отправьте изменения в ветку (git push origin feature/AmazingFeature)

5. Откройте Pull Request

📄 Лицензия

Этот проект лицензирован по лицензии ISC.

Создано с ❤️ для сообщества разработчиков ИИ.