使用说明
线性MCP服务器
重要提示: 此MCP服务器现已弃用,不再进行维护。我建议您在此处使用官方的Linear远程MCP服务器:https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)
该服务器通过MCP与Linear的问题跟踪系统集成,允许LLM与Linear问题进行交互。
安装
自动安装
通过以下方式自动安装Claude Desktop的Linear MCP服务器 史密瑟里:
npx @smithery/cli install linear-mcp-server --client claude
手动安装
-
为您的团队创建或获取线性API密钥: https://linear.app/YOUR-TEAM/settings/api
-
将服务器配置添加到Claude Desktop:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- MacOS:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}
组件
工具
-
linear_create_issue:创建新的线性问题- 所需输入:
title(string):发行标题teamId(string):在中创建问题的团队ID
- 可选输入:
description(string):问题描述(支持markdown)priority(数字,0-4):优先级(1=紧急,4=低)status(string):初始状态名称
- 所需输入:
-
linear_update_issue:更新现有问题- 所需输入:
id(string):要更新的问题ID
- 可选输入:
title(string):新标题description(string):新描述priority(数字,0-4):新优先级status(string):新状态名称
- 所需输入:
-
linear_search_issues:使用灵活的筛选搜索问题- 可选输入:
query(string):在标题/描述中搜索的文本teamId(string):按团队筛选status(string):按状态筛选assigneeId(string):按受让人筛选labels(string[]):按标签筛选priority(数字):按优先级筛选limit(数字,默认值:10):最大结果
- 可选输入:
-
linear_get_user_issues:将问题分配给用户- 可选输入:
userId(string):用户ID(对于经过身份验证的用户省略)includeArchived(boolean):包括已存档的问题limit(数字,默认值:50):最大结果
- 可选输入:
-
linear_add_comment:为问题添加评论- 所需输入:
issueId(string):要评论的问题IDbody(string):注释文本(支持markdown)
- 可选输入:
createAsUser(string):自定义用户名displayIconUrl(字符串):自定义头像URL
- 所需输入:
资源
linear-issue:///{issueId}-查看单个问题详细信息linear-team:///{teamId}/issues-查看团队问题linear-user:///{userId}/assigned-查看用户分配的问题linear-organization:-查看组织信息linear-viewer:-查看当前用户上下文
使用示例
您可以使用Claude Desktop与Linear交互的一些示例提示:
-
“让我看看我所有的快乐-优先级 问题”→执行
search_issues工具和/或linear-user:///{userId}/assigned查找分配给您的优先级为1的问题 -
“根据我已经告诉你的关于这个bug的信息,为身份验证系统制作一份bug报告”→ use
create_issue创建具有适当详细信息和状态跟踪的新高优先级问题 -
“查找所有正在进行的前端任务”→ use
search_issues在进行中的任务中查找前端相关问题 -
“给我一份关于移动应用程序开发问题的最新更新摘要”→ use
search_issues识别相关问题,然后linear-issue:///{issueId}获取问题详细信息并显示最近的活动和评论 -
“移动团队目前的工作量是多少?”→ 结合
linear-team:///{teamId}/issues和search_issues分析整个移动团队的问题分布和优先级
发展
- 安装依赖项:
npm install
- 在中配置线性API密钥
.env:
LINEAR_API_KEY=your_api_key_here
- 构建服务器:
npm run build
对于自动重建的开发:
npm run watch
许可证
此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息,请参阅项目存储库中的LICENSE文件。
