使用说明

项目简介

Linear Integration Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供与 Linear issue跟踪系统的集成。通过此服务器，LLM 可以访问和操作 Linear 中的 issue 数据，实现诸如创建 issue、更新 issue、搜索 issue、添加评论等功能，从而将 LLM 应用与项目管理流程紧密结合。

主要功能点

问题 (Issue) 管理: 允许 LLM 创建、更新和搜索 Linear 中的 issue。
资源 (Resources) 访问: 提供对 Linear issue、团队、用户和组织信息的标准化访问，例如获取 issue 详情、团队 issue 列表、用户分配的 issue 等。
工具 (Tools) 调用: 提供一系列预定义的工具，例如 'linear_create_issue' (创建 issue), 'linear_update_issue' (更新 issue), 'linear_search_issues' (搜索 issue), 'linear_get_user_issues' (获取用户 issue), 'linear_add_comment' (添加评论)。
Prompt 模板 (Prompts): 内置了 'linear-server-prompt' 模板，为用户提供使用该服务器的指导和最佳实践。
速率限制: 内置速率限制器，以确保与 Linear API 的交互平稳，避免超出 API 调用限制。

安装步骤

方法一：通过 Smithery 自动安装 (适用于 Claude Desktop)

如果使用 Smithery 和 Claude Desktop，可以使用以下命令自动安装：

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

方法二：手动安装 (适用于 Claude Desktop 或其他 MCP 客户端)

获取 Linear API Key: 访问 https://linear.app/YOUR-TEAM/settings/api (将 'YOUR-TEAM' 替换为你的 Linear 团队名称)，创建一个 Linear API Key。
配置 Claude Desktop (或其他 MCP 客户端):
- 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
  - MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- 在 'mcpServers' 字段下添加 'linear' 服务器配置。

服务器配置 (claude_desktop_config.json)

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

配置参数说明:

'server name': 'linear' (服务器名称，可以自定义，用于在客户端中引用)
'command': 'npx' (启动服务器的命令，这里使用 'npx' 运行 npm 包)
'args':
- '-y': (npm 参数，表示自动确认安装包)
- '@modelcontextprotocol/server-linear': (实际运行的 npm 包名称，即 Linear MCP Server)
'env': (环境变量)
- 'LINEAR_API_KEY': 'your_linear_api_key_here' (必须替换为你之前获取的 Linear API Key)

注意:

确保已安装 Node.js 和 npm。
'@modelcontextprotocol/server-linear' 是该仓库构建后的 npm 包名称，实际配置时请根据仓库的 npm 包发布情况进行调整。
'LINEAR_API_KEY' 是连接 Linear API 的凭证，务必替换为你自己的 API Key。

基本使用方法

配置完成后，在 Claude Desktop (或其他 MCP 客户端) 中，你可以通过自然语言指令调用 Linear Integration Server 提供的功能。

示例 Prompt:

创建 Issue: "创建一个标题为 '修复用户认证bug'，团队为 '技术支持' 的高优先级 issue" (LLM 可能会调用 'linear_create_issue' 工具，并填充相应的参数，例如 'title: "修复用户认证bug"', 'teamId: "技术支持团队的ID"', 'priority: 1')
搜索 Issue: "搜索所有 '前端' 相关的 '进行中' 的 issue" (LLM 可能会调用 'linear_search_issues' 工具，并填充参数，例如 'query: "前端"', 'status: "In Progress"')
查看我的 Issue: "展示我所有高优先级的 issue" (LLM 可能会读取 'linear-user:///{userId}/assigned' 资源，并过滤出高优先级的 issue)

提示:

你可以参考仓库的 'README.md' 文件中 "Usage examples" 部分，获取更多使用示例。
使用 'linear-server-prompt' Prompt 模板可以获取更详细的服务器使用说明和最佳实践。
在实际使用中，LLM 会根据你的自然语言指令，自动选择合适的工具或资源，并调用 Linear Integration Server 完成操作。

关键词