关键词

Linear集成问题追踪AI助手协作工具API桥接

项目简介

Linear MCP 服务器是基于 Model Context Protocol (MCP) 构建的应用后端，专门用于与 Linear API 交互。它为 MCP 客户端（如 AI 助手）提供了一套标准化的接口，用于访问 Linear 中的资源（如问题、项目、团队）并执行相关操作（如创建、更新、删除问题和评论）。

主要功能点

  • 资源访问： 获取 Linear 中的项目列表、特定项目详情、问题详情、团队信息、当前用户信息等。
  • 问题管理： 支持创建、更新、删除 Linear 中的问题，包括修改标题、描述、项目、标签、优先级、估算值和状态。
  • 评论管理： 支持创建、更新、删除问题下的评论，并获取特定问题的所有评论。
  • 问题搜索： 提供强大的问题搜索和过滤功能，支持按关键词、ID、团队、经办人、项目、状态、标签等多种条件搜索。
  • 状态与标签查询： 查询所有可用的项目状态和问题工作流状态，以及所有问题标签。
  • 标准化接口： 通过 MCP 标准化协议与客户端通信，简化 AI 助手集成 Linear 的过程。

安装步骤

可以直接使用 'npx' 运行，无需全局安装：

  1. 设置认证信息： 在运行服务器的环境中设置 Linear API 密钥或 OAuth 凭据作为环境变量。

    • API 密钥： 设置 'LINEAR_API_KEY=你的API密钥'
    • OAuth： 设置 'LINEAR_OAUTH_CLIENT_ID=你的Client ID' 和 'LINEAR_OAUTH_CLIENT_SECRET=你的Client Secret'
    • 推荐使用 OAuth 方式。如果两者都设置，OAuth 优先。

  2. 启动服务器： 在终端中运行以下命令（请将 '你的API密钥' 替换为实际值）：

    LINEAR_API_KEY=你的API密钥 npx -y @mkusaka/mcp-server-linear

服务器配置（针对 MCP 客户端）

MCP 客户端（如兼容 MCP 的 AI 助手或工具）需要配置如何启动和连接到这个 MCP 服务器。通常，这涉及在客户端的设置文件中添加服务器信息，格式类似于 JSON。以下是配置此服务器所需的主要信息：

  • 服务器名称： 例如，可以命名为 'linear'。
  • 启动命令 ('command')： 'npx'
  • 命令参数 ('args')： '["-y", "@mkusaka/mcp-server-linear"]'
  • 环境变量 ('env')： 在此处设置 Linear 认证所需的环境变量，例如：
    • 设置 API 密钥：'{ "LINEAR_API_KEY": "你的API密钥" }'
    • 或设置 OAuth 凭据：'{ "LINEAR_OAUTH_CLIENT_ID": "你的Client ID", "LINEAR_OAUTH_CLIENT_SECRET": "你的Client Secret" }' 请根据您使用的 MCP 客户端的具体配置格式，将这些信息填入对应的字段中。

基本使用方法

一旦 MCP 服务器通过标准输入/输出 (Stdio) 与 MCP 客户端成功连接，AI 助手或其他客户端应用就可以通过 MCP 协议调用服务器提供的工具和资源。例如，AI 助手在接收到用户关于 Linear 的请求时，会解析用户的意图，然后向 Linear MCP 服务器发送对应的 MCP 请求，调用 'create_issue'、'search_issues' 或 'get_issue' 等工具，从而在 Linear 中执行操作或获取信息，并将结果呈现给用户。用户无需直接与服务器交互，所有交互都通过 MCP 客户端进行。

信息

分类

开发者工具

访问项目