MCP 服务器

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它允许 Claude 与 Linear 的 API 交互，以管理团队、问题、项目和周期。

通信

开发者工具

TypeScript

访问服务器

README

Linear MCP 服务器

这是一个 Linear 的模型上下文协议 (MCP) 服务器，允许 Claude 与 Linear 的 API 交互，以管理团队、问题、项目和周期。

功能

linear_get_teams: 获取所有团队及其状态和标签
linear_search_issues: 搜索问题，支持过滤和分页
linear_get_cycles: 获取团队的所有周期
linear_get_projects: 获取所有项目
linear_create_issue: 创建新问题
linear_update_issue: 更新现有问题

快速开始

对于 Cline MCP Marketplace 用户：

通过 Cline MCP Marketplace 安装服务器
在 MCP 配置文件中配置您的 Linear 凭据
通过 linear_search_issues 测试连接来验证安装

请参阅下面的详细安装和验证部分。

安装

克隆此存储库
安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```

安装过程主要有三个步骤：

设置: 克隆并构建服务器（上述步骤）
配置: 设置您的 Linear OAuth 令牌并配置 MCP 服务器
验证: 测试连接以确保其正常工作

⚠️ 在您验证连接正常工作之前，您的安装尚未完成！

配置

服务器需要 Linear OAuth 令牌才能通过 Linear API 进行身份验证。您可以在 MCP 配置文件中设置此令牌。

获取 Linear 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": "示例问题 1",
        "identifier": "TEAM-123",
        "description": "这是一个示例问题"
        // ... 其他问题数据
      },
      // ... 更多问题
    ]
  }
}

如果连接正常工作，您将看到来自您的 Linear 帐户的问题列表。如果您看到错误，请检查您的配置和凭据。

常见问题：

args 字段中的服务器路径不正确
Linear 令牌无效或已过期
缺少必需的环境变量
服务器在配置中被禁用

用法

获取团队

使用 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": "可选搜索查询",
    "teamIds": ["可选团队 ID"],
    "first": 10 // 要返回的问题数量（默认值：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 // 要返回的项目数量（默认值：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": "必需的问题标题",
    "description": "可选的问题描述",
    "assigneeId": "optional-assignee-id",
    "stateId": "optional-state-id",
    "priority": 0, // 可选优先级 (0-4)
    "estimate": 1, // 可选估计
    "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": "可选的新标题",
    "description": "可选的新描述",
    "assigneeId": "optional-assignee-id",
    "stateId": "optional-state-id",
    "priority": 0, // 可选优先级 (0-4)
    "estimate": 1, // 可选估计
    "cycleId": "optional-cycle-id",
    "projectId": "optional-project-id",
    "labelIds": ["optional-label-ids"]
  }
)

调试

如果您在验证步骤期间遇到问题，或者 MCP 连接停止工作，您可以使用以下调试技术：

检查 MCP 配置：确保您的 MCP 配置文件具有正确的服务器路径和凭据。
运行测试客户端：使用包含的测试客户端来验证服务器是否可以连接到 Linear：
```
node test-client.js
```
这将运行一系列测试，以验证服务器是否可以连接到 Linear 并检索数据。
检查 Linear API 状态：在 status.linear.app 验证 Linear API 是否正常运行。
检查服务器日志：如果您手动运行服务器，请检查控制台输出中的错误消息。