Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个用于与 Linear API 交互的 MCP 服务器，旨在通过 MCP 协议提供对 Linear 问题的管理和操作能力。

核心功能

• 创建、更新和搜索 Linear 问题
• 获取用户分配的问题
• 添加评论到问题
• 检索团队信息
• 支持速率限制的 API 请求，以遵守 Linear 的 API 限制

适用场景

• 团队协作中的问题管理
• 自动化任务管理
• AI 助手集成

工具列表

1. linear_create_issue: 创建新的 Linear 问题，支持子问题和标签分配。
2. linear_update_issue: 更新现有 Linear 问题的属性。
3. linear_search_issues: 使用灵活条件搜索 Linear 问题。
4. linear_get_user_issues: 检索分配给特定用户或认证用户的问题。
5. linear_get_issue: 通过 ID 检索单个 Linear 问题。
6. linear_add_comment: 向现有 Linear 问题添加评论。
7. linear_get_teams: 检索 Linear 团队，支持名称过滤。

常见问题解答

• 如何启用写权限？使用 --write-access 标志运行服务器。
• 如何自动批准特定工具？使用 --auto-approve 标志指定工具列表。

使用教程

使用依赖

• Go 1.23 或更高版本
• Linear API 密钥

安装教程

从发布版本安装

1. 从 GitHub Releases 页面 下载适用于您平台的二进制文件。
2. 使其可执行（Linux/macOS）：

chmod +x linear-mcp-go-*

1. 按照使用部分所述运行二进制文件。

自动化安装

# 下载最新版本的 Linux 二进制文件
RELEASE=$(curl -s https://api.github.com/repos/geropl/linear-mcp-go/releases/latest)
DOWNLOAD_URL=$(echo $RELEASE | jq -r '.assets[] | select(.name | contains("linux")) | .browser_download_url')
curl -L -o ./linear-mcp-go $DOWNLOAD_URL
chmod +x ./linear-mcp-go

# 设置 mcp 服务器
./linear-mcp-go setup --tool=cline

调试方式

1. 设置 Linear API 密钥环境变量：

export LINEAR_API_KEY=your_linear_api_key

1. 运行服务器：

# 以只读模式运行（默认）
./linear-mcp-go serve

# 启用写访问运行
./linear-mcp-go serve --write-access

测试

使用 go-vcr 实现测试，针对 https://linear.app/linear-mcp-go-test 执行。

执行测试

使用现有记录（cassettes）：

go test -v ./...

重新录制测试

需要设置 LINEAR_API_KEY。

go test -v -record=true ./...

这将更新所有不改变远程状态的测试。

go test -v -recordWrites=true ./...

这将重新运行所有测试，包括可能改变其他测试结果的测试，可能需要手动调整。

go test -v -golden=true ./...

更新所有 .golden 字段。

发布流程

项目使用 GitHub Actions 进行自动化测试和发布： 1. 所有推送到主分支和拉取请求都会自动测试。 2. 当推送匹配 v* 模式的标签时（例如 v1.0.0），会自动创建新版本。 3. 为 Linux、macOS 和 Windows 构建二进制文件并附加到版本中。

创建新版本： 1. 更新 pkg/server/server.go 中的版本。 2. 提交更改。 3. 创建并推送匹配版本的标签：

git tag v1.0.0
git push origin v1.0.0

GitHub Actions 工作流将自动创建带有适当二进制文件的版本。

许可证

MIT

许可证

该项目遵循 MIT 开源许可条款。