🚀 Linear-MCP-for-Gemini_CLI

License: ISC Node.js Version Model Context Protocol

这是一个功能强大的开源 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 步：下载并构建服务器

将仓库克隆到您的机器：

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

安装所需的包：
```
npm install
```
编译代码：
```
npm run build
```
（为什么要这样做？此命令将 TypeScript 代码转换为 dist/index.js 文件，这正是 Gemini CLI 将用于与 Linear 通信的文件）。

第 2 步：获取您的 Linear API 密钥

导航到 Linear 工作区中的 Settings > API > Personal API keys。
点击 New API key 并为其命名（例如“Gemini CLI”）。
复制密钥（您将在最后一步用到它）。

第 3 步：连接到 Gemini CLI（仅需此设置）

现在我们告诉 Gemini CLI 在哪里可以找到已构建的服务器，并安全地提供您的 API 密钥。您可以通过编辑 Gemini CLI 设置文件来完成此操作。

找到您的设置文件： 打开文件资源管理器或终端，找到用户主目录下的 .gemini 文件夹：
- Windows： %USERPROFILE%\.gemini\settings.json（例如 C:\Users\YourName\.gemini\settings.json）
- Mac/Linux： ~/.gemini/settings.json （注意：如果 .gemini 文件夹或 settings.json 文件尚不存在，请直接创建它们）。
添加配置： 使用任何文本编辑器（如 VS Code、Notepad 或 TextEdit）打开 settings.json，并粘贴以下 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 替换为您在第 2 步中复制的实际 API 密钥。

第 4 步：开始聊天！

关闭并重新打开您的终端以重启 Gemini CLI 会话。集成现已激活！

尝试询问 Gemini CLI 诸如：

“列出我的 Linear 团队。” “查找关于登录错误的议题。” “在 Engineering 团队中创建一个新的高优先级议题来更新 README。”

🤖 自动连接机制（工作原理）

您可能想问：“我每次想使用它时都需要运行 npm start 吗？我需要手动设置服务器连接吗？”

不需要！您无需执行任何额外操作。

在 第 3 步 中添加配置块是唯一需要的设置。以下是底层发生的情况：

零接触启动： 因为您将配置添加到了 settings.json，Gemini CLI 会原生充当宿主。
后台执行： 每次您启动新的 Gemini CLI 聊天时，它都会自动在隐藏的后台进程中启动此 Linear MCP 服务器。
安全握手： Gemini CLI 从您的设置中读取 "LINEAR_API_KEY" 并将其安全地直接注入到服务器中。
清理关闭： 当您关闭 Gemini CLI 时，后台服务器会自动终止。

您只需在设置中配置一次，Model Context Protocol 就会自动为您处理整个生命周期！

🤝 贡献

贡献是开源社区学习、启发和创造的动力。您所做的任何贡献都非常感谢。

Fork 项目
创建您的功能分支 (git checkout -b feature/AmazingFeature)
提交您的更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开 Pull Request

📄 许可证

本项目采用 ISC License 授权。

为 AI 开发者社区倾心打造。

Linear MCP Server