Linear MCP Server 使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它将 Linear 项目管理平台的功能通过 MCP 协议暴露给 LLM（大型语言模型）客户端。借助此服务器，LLM 应用可以方便地查询和操作 Linear 中的 issues（任务）、projects（项目）、teams（团队）等资源，实现更智能化的项目管理和协作。

主要功能点

Issue 管理:
- 获取 issue 详情 (get_issue)
- 获取团队 issue 列表 (get_team_issues)
- 创建 issue (create_issue)
- 更新 issue (update_issue)
- 获取 issue 的子 issue 列表 (get_issue_children)
Project 管理:
- 创建 project (create_project)
- 更新 project (update_project)
Team 信息:
- 获取团队列表 (get_teams)

安装步骤

克隆仓库

git clone https://github.com/jtrim/linear-mcp.git
cd linear-mcp

安装 Go 依赖 确保已安装 Go 语言环境。在项目根目录下执行：
```
go mod tidy
```

编译服务器

go build -o linear-mcp-server main.go

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到 Linear MCP Server。

{
  "serverName": "linear-mcp-server",
  "command": "./linear-mcp-server",
  "args": [],
  "env": {
    "LINEAR_API_KEY": "<Your Linear API Key>"
  },
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，可以自定义，例如 "linear-mcp-server"。
'command': 服务器启动命令。这里假设编译后的可执行文件名为 'linear-mcp-server'，并且在当前目录下。请根据实际情况修改。
'args': 启动参数。此服务器不需要额外的启动参数，因此为空数组 '[]'。
'env': 环境变量。
- 'LINEAR_API_KEY': 必须配置。请替换 '<Your Linear API Key>' 为你的 Linear API 密钥。你需要在 Linear 平台获取 API 密钥。
'transport': 传输协议。此服务器使用标准输入输出 (stdio) 作为 MCP 传输协议，因此设置为 '"stdio"'。

重要提示:

Linear API Key: 请务必将 '<Your Linear API Key>' 替换为你在 Linear 平台申请的 API 密钥。API 密钥用于服务器访问 Linear API，请妥善保管。
运行环境: 确保运行 MCP 客户端和服务器的环境能够访问 Linear API (通常需要能够访问外网)。

基本使用方法

启动服务器 在配置好环境变量 'LINEAR_API_KEY' 后，在服务器所在目录运行编译生成的可执行文件：
```
./linear-mcp-server
```
服务器默认使用 stdio 传输协议，启动后会监听标准输入，等待 MCP 客户端的请求。
配置 MCP 客户端 在你的 MCP 客户端应用中，按照客户端的要求配置上述提供的服务器配置 JSON。
通过 MCP 客户端调用工具 配置完成后，你就可以在 MCP 客户端中调用 Linear MCP Server 提供的工具了。例如，你可以调用 'get_issue' 工具来获取指定 ID 的 issue 信息，或者调用 'create_issue' 工具来创建一个新的 issue。

具体的工具调用方法和参数，请参考 MCP 客户端的文档和 Linear MCP Server 的代码定义 (例如 'main.go' 文件中 'server.RegisterTool' 的部分)。

示例工具调用 (MCP 客户端发起请求)

假设你要使用 'get_issue' 工具获取 issue ID 为 "TEST-123" 的 issue 信息，MCP 客户端会向 Linear MCP Server 发送符合 MCP 协议的 JSON-RPC 请求，请求中会包含工具名称 "get_issue" 和参数 '{"id": "TEST-123"}'。服务器处理请求后，会将 issue 的 JSON 数据封装在 MCP 响应中返回给客户端。

// MCP 客户端请求示例 (简化)
{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "tool_call": {
      "tool_name": "get_issue",
      "arguments": {
        "id": "TEST-123"
      }
    }
  },
  "id": "1"
}

Linear MCP Server 会返回包含 issue 信息的 JSON-RPC 响应。

// MCP 服务器响应示例 (简化)
{
  "jsonrpc": "2.0",
  "result": {
    "tool_response": {
      "content": {
        "type": "text",
        "text": "{...issue data in JSON format...}"
      }
    }
  },
  "id": "1"
}

请查阅 MCP 协议文档和你的 MCP 客户端的具体使用说明，以了解更详细的请求和响应格式。

关键词