Linear MCP Server 使用教程

1. 项目介绍

Linear MCP Server 是一个开源项目，它集成了 Linear 的项目管理系统与模型上下文协议（MCP），使得大型语言模型（LLM）能够与 Linear 的问题跟踪系统进行交互。此服务器为开发者提供了一个通过 MCP 协议与 Linear API 交互的平台。

2. 项目快速启动

自动安装

要自动安装 Linear MCP Server 以供 Claude Desktop 使用，可以通过 Smithery CLI 执行以下命令：

npx @smithery/cli install linear-mcp-server --client claude

手动安装

1. 首先，为您团队创建或获取一个 Linear API key：Linear API 设置。

2. 将服务器配置添加到 Claude Desktop 中。对于 MacOS，编辑以下文件：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   添加以下内容：

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": ["-y", "linear-mcp-server"],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

3. 确保安装了所有依赖项：

   npm install
   

4. 在 .env 文件中配置 Linear API key：

   LINEAR_API_KEY=your_api_key_here
   

5. 构建服务器：

   npm run build
   

6. 若要开发时自动重建，运行：

   npm run watch
   

3. 应用案例和最佳实践

以下是一些使用 Linear MCP Server 的案例和最佳实践：

• 创建新问题：通过执行 create_issue 动作，您可以创建一个带有适当详细信息和状态跟踪的新问题。
• 搜索问题：使用 search_issues 工具可以定位特定的问题，如高优先级问题或进行中的前端任务。
• 查看问题详情：通过 linear-issue:///{issueId} 可以查看单个问题的详细信息。
• 分析团队工作负载：结合 linear-team:///{teamId}/issues 和 search_issues 可以分析团队的问题分布和优先级。

4. 典型生态项目

目前 Linear MCP Server 项目周边的典型生态项目包括但不限于：

• Smithery CLI：用于自动安装和管理 Linear MCP Server 的命令行工具。
• Claude Desktop：一个桌面客户端，允许通过 MCP 协议与 Linear MCP Server 交互。

通过这些生态项目，开发者可以更高效地与 Linear MCP Server 进行交互，提升开发效率。