线性 MCP 服务器
这是 Linear 的模型上下文协议 (MCP) 服务器，允许 Claude 与 Linear 的 API 交互来管理团队、问题、项目和周期。
特征
linear_get_teams ：获取所有球队及其状态和标签
linear_search_issues ：搜索过滤和分页问题
linear_get_cycles ：获取团队的所有周期
linear_get_projects ：获取所有项目
linear_create_issue ：创建新问题
linear_update_issue ：更新现有问题
Related MCP server: Backlog MCP Server
快速入门
对于 Cline MCP Marketplace 用户：
通过 Cline MCP Marketplace安装服务器
在 MCP 配置文件中配置您的 Linear 凭据
通过测试与linear_search_issues的连接来验证安装
请参阅下面详细的安装和验证部分。
安装
克隆此存储库
安装依赖项：
构建服务器：
安装过程主要分为三个步骤：
设置：克隆并构建服务器（上述步骤）
配置：设置您的 Linear OAuth 令牌并配置 MCP 服务器
验证：测试连接以确保其正常工作
⚠️在您确认连接正常之前，您的安装尚未完成！
配置
服务器需要 Linear OAuth 令牌才能使用 Linear API 进行身份验证。您可以在 MCP 配置文件中设置此令牌。
获取线性 OAuth 令牌
在https://linear.app/settings/api/applications创建一个 Linear OAuth 应用程序
创建 OAuth 应用程序
将应用程序命名为 Cline MCP
将重定向 URI 设置为http://localhost:3000/callback
记下客户端 ID 和客户端密钥
创建并复制基于用户的开发者令牌
MCP 配置
将以下内容添加到您的 MCP 配置文件中：
{
"mcpServers": {
"github.com/cpropster/linear-mcp-server": {
"command": "node",
"args": [
"/path/to/linear-mcp-server/build/index.js"
],
"env": {
"LINEAR_CLIENT_ID": "your-client-id",
"LINEAR_CLIENT_SECRET": "your-client-secret",
"LINEAR_REDIRECT_URI": "http://localhost:3000/callback",
"LINEAR_REFRESH_TOKEN": "your-refresh-token"
},
"disabled": false,
"autoApprove": []
}
}
}
将占位符凭据替换为您的实际凭据。
验证安装
⚠️重要提示：在您验证 MCP 连接正常工作之前，您的安装尚未完成。
配置 MCP 服务器后，您必须测试连接以确保其正常工作：
重新加载 MCP 配置
使用linear_search_issues工具测试连接：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_search_issues",
arguments={
"first": 5
}
)
如果成功，您将看到如下响应：
{
"issues": {
"nodes": [
{
"id": "123abc",
"title": "Example issue 1",
"identifier": "TEAM-123",
"description": "This is an example issue"
// ... other issue data
},
// ... more issues
]
}
}
如果连接正常，您将看到 Linear 帐户中的问题列表。如果发现错误，请检查您的配置和凭据。
常见问题：
args字段中的服务器路径不正确
无效或过期的线性令牌
缺少必需的环境变量
服务器在配置中被禁用
用法
获取团队
使用linear_get_teams工具检索所有团队：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_get_teams",
arguments={}
)
搜索问题
使用linear_search_issues工具搜索问题：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_search_issues",
arguments={
"query": "Optional search query",
"teamIds": ["Optional team IDs"],
"first": 10 // Number of issues to return (default: 50)
}
)
获取周期
使用linear_get_cycles工具检索团队的周期：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_get_cycles",
arguments={
"teamId": "required-team-id"
}
)
获取项目
使用linear_get_projects工具检索项目：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_get_projects",
arguments={
"teamId": "optional-team-id",
"first": 10 // Number of projects to return (default: 50)
}
)
创建问题
使用linear_create_issue工具创建新问题：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_create_issue",
arguments={
"teamId": "required-team-id",
"title": "Required issue title",
"description": "Optional issue description",
"assigneeId": "optional-assignee-id",
"stateId": "optional-state-id",
"priority": 0, // Optional priority (0-4)
"estimate": 1, // Optional estimate
"cycleId": "optional-cycle-id",
"projectId": "optional-project-id",
"labelIds": ["optional-label-ids"]
}
)
更新问题
使用linear_update_issue工具更新现有问题：
use_mcp_tool(
server_name="github.com/cpropster/linear-mcp-server",
tool_name="linear_update_issue",
arguments={
"issueId": "required-issue-id",
"title": "Optional new title",
"description": "Optional new description",
"assigneeId": "optional-assignee-id",
"stateId": "optional-state-id",
"priority": 0, // Optional priority (0-4)
"estimate": 1, // Optional estimate
"cycleId": "optional-cycle-id",
"projectId": "optional-project-id",
"labelIds": ["optional-label-ids"]
}
)
调试
如果您在验证步骤中遇到问题，或者 MCP 连接停止工作，您可以使用以下调试技术：
检查 MCP 配置：确保您的 MCP 配置文件具有正确的服务器路径和凭据。
运行测试客户端：使用附带的测试客户端验证服务器是否可以连接到 Linear：
这将运行一系列测试来验证服务器是否可以连接到 Linear 并检索数据。
检查线性 API 状态：验证线性 API 是否在status.linear.app上运行。
检查服务器日志：如果您手动运行服务器，请检查控制台输出中的错误消息。
发展
该服务器使用 TypeScript 和 Linear SDK 构建。主要实现位于src/index.ts中。
要对服务器进行更改：
编辑src/中的源代码
使用npm run build构建服务器
使用测试客户端测试您的更改
更新 MCP 配置以使用新版本
安全注意事项
此 MCP 服务器需要访问您的 Linear 帐户。为了确保您的数据安全：
切勿提交敏感令牌： .env文件和任何包含令牌的文件都被排除在.gitignore之外
使用环境变量：在 MCP 配置中始终使用环境变量，而不是硬编码令牌
限制权限：创建线性 OAuth 应用程序时，仅授予所需的权限
定期轮换令牌：定期生成新令牌并更新您的配置
服务器使用官方的 Linear SDK，并通过 HTTPS 与 Linear 的 API 通信，确保您的数据安全传输。
执照
麻省理工学院
