项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它允许AI助手通过标准化的 MCP 协议与 Linear 项目管理工具进行交互。该服务器充当桥梁，使得AI助手能够理解和操作 Linear 中的 issue、团队等资源，从而实现更智能化的工作流自动化。

主要功能点

问题管理: 创建、更新和搜索 Linear 中的 issue，方便 AI 助手跟踪和管理任务。
用户信息: 获取指派给特定用户的 issue 列表，或者获取当前用户的所有 issue。
团队信息: 检索 Linear 团队信息，支持按名称过滤。
评论功能: 在 Linear issue 中添加评论，方便 AI 助手参与讨论和协作。
速率限制: 内置速率限制机制，尊重 Linear API 的使用限制，保证服务的稳定运行。
可扩展性: 支持通过命令行参数配置读写权限和工具自动批准策略，适应不同的安全和使用场景。

安装步骤

下载预编译二进制文件 (推荐)

访问 GitHub Releases 页面下载适合您操作系统的预编译二进制文件 (Linux, macOS, Windows)。
使二进制文件可执行 (Linux/macOS)

在终端中，使用 'chmod +x' 命令为下载的文件添加执行权限，例如：
```
chmod +x linear-mcp-go-*
```
运行服务器 (参见 "服务器配置" 和 "基本使用方法")

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到 Linear MCP Server。以下是 Cline (VSCode 扩展) 的配置示例，其他 MCP 客户端的配置方式类似。

{
  "mcpServers": {
    "linear": {
      "command": "/path/to/linear-mcp-go",  // Linear MCP Server 的可执行文件路径，请替换为实际路径，例如：/Users/yourname/mcp-servers/linear-mcp-go
      "args": ["serve"],                     // 启动服务器的命令行参数，默认为只读模式
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key" // 您的 Linear API 密钥，请替换为实际密钥
      },
      "disabled": false,                     // 设置为 false 启用该 MCP 服务器
      "autoApprove": []                      // 自动批准的工具列表，默认为空，表示所有工具都需要手动批准
    }
  }
}

参数说明:

'command': 必填。Linear MCP Server 可执行文件的绝对路径。
'args': 可选。启动服务器的命令行参数，例如：
- '["serve"]': 以只读模式启动服务器 (默认)。
- '["serve", "--write-access"]': 以读写模式启动服务器，启用创建、更新 issue 和添加评论等功能。
'env': 必填。环境变量配置，其中 'LINEAR_API_KEY' 必须设置为您的 Linear API 密钥。
'disabled': 可选。设置为 'true' 禁用该服务器，设置为 'false' 启用。默认为 'false'。
'autoApprove': 可选。自动批准的工具名称列表。例如：
- '["linear_search_issues", "linear_get_issue"]': 自动批准 'linear_search_issues' 和 'linear_get_issue' 工具。
- '["allow-read-only"]': 自动批准所有只读工具 ('linear_search_issues', 'linear_get_user_issues', 'linear_get_issue', 'linear_get_teams')。

注意: 请根据您的实际情况修改 'command'、'args' 和 'LINEAR_API_KEY' 的值。

基本使用方法

设置 Linear API 密钥

在运行服务器之前，请确保已将您的 Linear API 密钥设置为环境变量 'LINEAR_API_KEY'。在终端中执行以下命令 (请替换 'your_linear_api_key' 为您的实际密钥)：
```
export LINEAR_API_KEY=your_linear_api_key
```
启动 Linear MCP Server

在终端中，导航到您下载的 'linear-mcp-go' 二进制文件所在的目录，并执行以下命令启动服务器 (默认只读模式)：
```
./linear-mcp-go serve
```
如果需要启用写访问权限，请使用 '--write-access' 参数：
```
./linear-mcp-go serve --write-access
```
服务器启动后，将监听标准输入/输出 (stdin/stdout) 上的 MCP 请求。
在 MCP 客户端中使用

配置您的 MCP 客户端 (例如 Cline) 以连接到 Linear MCP Server。配置信息请参考 "服务器配置" 部分。配置完成后，您就可以在 MCP 客户端中使用 Linear 提供的工具来管理 Linear issue、查询团队信息等。具体工具的使用方法请参考各个工具的描述信息。

示例工具调用 (在 MCP 客户端中):

搜索 issue: 调用 'linear_search_issues' 工具，并提供查询关键词、团队 ID 等参数。
获取 issue 详情: 调用 'linear_get_issue' 工具，并提供 issue ID。
创建 issue (如果服务器以读写模式启动): 调用 'linear_create_issue' 工具，并提供 issue 标题、团队 ID 等参数。

请参考 MCP 客户端的文档了解如何在客户端中调用和使用 MCP 工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息